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DECnet-RSX STUDENT GUIDE (SWS) 



COURSE DESCRIPTION 

This lecture/lab course prepares system programmers, 
application programmers, and system and network managers to use, 
install, monitor, and trpubleshoot DECnet on RSX-llM/M-PLUS/S 
systems. This course prepares specialists to support the 
DECnet-RSX software. Emphasis is placed on the following topics: 
defining the user interface, using the network utilities, and 
generating a DECnet system- These topics are also emphasized: 
performance considerations, internal components, structures, data 
flow, and presales of DECnet-RSX (for SWS only). This course 
includes a section on writing programs that perform intertask 
communication using RSX-llM/M-PLUS/S supported languages. 



COURSE GOALS 

Upon completion of this course the specialist should be able 
to: 



• Describe the DECnet-RSX product features. 

• Use the Network Management interface to perform monitoring, 
managing, and testing functions. 

• Perform DECnet-RSX generation and installation. 

• Write programs that perform intertask communications using 
any of the supported RSX-llM/M-PLUS/S languages. 

• Trace the DECnet-RSX internal data structures and data 
flows. 



NON-GOALS 



This course is not intended to: 



• Provide support training for Ethernet or any of the 
products on: the Ethernet Server Base. These topics are 
handled separately in the Ethernet Server Support course 
(SWS only). Customers receive Ethernet Server related 
information from the Local Area Network Seminar. 

• Be a comprehensive network troubleshooting course. 

• Teach heterogeneous network support. 



DECnet-RSX STUDENT GUIDE (SWS) 

PREREQUISITES 

Before enrolling in this course/ ydu "should be able to: 



• Discuss on a technical level, tHe functions and layers of 
the DIGITAL Network Architecture (DNA) . 

• Describe the characteristics and functions of the network 
components. 

• Program in any of the supported languages available on 
RSX-llM/M-PLUS/S (BASIC-PLUS II, FORTRAN-77, and MACRO-11). 

• Generate and support a RSX-llM/M-PLUS/S system. 

In addition to the skills listed, the SWS specialist should 
have a minimum of six months support of RSX-llM/M-PLUS/S. 

These Courses may help provide the skills necessiary to m§et 
the above prerequisites: re ~ 

• RSX-llM/M-PLUS/S Support (J1037) 

• Network Concepts (SPI) (EY-1379E-SG-0002) 

• DIGITAL Network Architecture CSPI) (EY-0149E-SG-0001) 

• Communications Interfaced and Modems Workshop "(J1029) 

• Packet Switching Concepts (SPI) 

• Programming in MACRO-11 (J2050-A) 
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COURSE TOPICS 

During the study of this pqurse, you will be asked to,: , , 

• Use DECnet-RSX utilities 

• Perform a DECnet-RSX generation and installation including 

- Selection of specific components 
Partition layout ._ .__, ....,,,_ 

- SYSGEN specific items 

- Performing a PREGEN 

- Performing a NETGEN 
Installation and Checkout of DECnet 

• Use the Network Management Utilities to:, 

- Configure a node ■>■-. 

- Configure a network c 

- Test nodes and network 

Control node and ne two rk. operation 
Inspect and monitor nodes in the network 

• Use available tools to troubleshoot node problems 

• Write and test intertask communication programs 
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COURSE MODULE BOOKLETS 

You should have the following module booklets that are 
included for this course. 

1. DECnet-RSX Overview ( Ey -Q\55t **56 "CdOS) 

2. DECnet-RSX User Interf ace (gV-Ol55g- SG - 0303 ^ 

3. DECnet-RSX Network Management fey - Q\ 556 »5€> -6<fp^ 

4. DECnet-RSX Packetnet System Interface (gN-OiaSg- SG - QgoVj 

5. DECnet-RSX Installation and Checkout (e^l - OlSSS- 56-050%) 

6. DECnet-RSX Additional Network Capabilities (eV-QiSSg- 56- OoPd) 

7. DECnet-RSX Performance Considerations feN " Ol55€~ S6~Q90S) 

8. DECnet-RSX Internals (eV" Q\SSe~ 5fc> -QloV) 

9. DECnet-RSX Node Troubleshooting ^BN " OlS££- S6 -) OOoA 
10. DECnet-RSX Presales (eV~Q\65G- 3e>-H0*V 
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DECnet-RSX OVERVIEW 



INTRODUCTION 

This module presents the major features of DECnet-RSX. 

DECnet is a set of software products that implement the 
DIGITAL Network Architecture (DNA) . For RSX-11 operating systems, 
DECnet is implemented as a layered product. DECnet-RSX represents 
the following products: 

• DECnet-llM, Version 4.0 (runs on RSX-11M, Version 4.1 or 
later) 

• DECnet-llM-PLUS, Version 2.0 (runs on RSX-11M-PLUS, Version 
2.1 or later) 

• DECnet-llS, Version 4.0 (runs on RSX-11S, Version 4.1 or 
later) 

DECnet-RSX also represents the following products in part: 

• RSX-11M PSI, Version 2.0 (runs on RSX-11M, Version 4.1 or 
later) 

• RSX-11M-PLUS PSI, Version 2.0 (runs on RSX-11M-PLUS, 
Version 2.1 or later) 

DECnet allows computers to be connected into a network either 
by using facilities provided by a common carrier (AT&T) or by 
using local available hardware interfaces (DEUNA) . Either way, 
DECnet is transparent to a network user, because DNA layers 
isolate the user from the physical characteristics of the network. 
The physical network itself may be shared among users. 

The Packetnet System Interface (PSI) allows computers to be 
connected by using the Packet Switching Network (PSN) which 
supports the CCITT X.25 set of recommendations. The PSI product 
can be integrated into DECnet during a NETGEN procedure and, in 
such a case, DECnet tasks are able to communicate with one another 
by using the X.25 network. For a DECnet user, the facility is 
transparent. As in DECnet, PSI lines may be shared among many 
users. 

The Direct Line Access Interface (DLX) allows two tasks 
located on adjacent nodes to communicate. This interface is 
simple; a user has full control over the physical line that 
connects the nodes. The line cannot be shared among many users. 
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OBJECTIVES 

To be successful in presales activity, the specialist must be 
able to: 

• List the important features of DECnet-RSX products. 

• Identify minimum hardware and software requirements for: 

- DECnet and PSI 

- DECnet 

- PSI 

- DLX 

• Explain the general data flow between tasks in DECnet 
and/or PSI. 



to : 



To be successful with DECnet-RSX, a network user must be able 



• Specify the network interfaces available to a user. 

• Identify the major features of a logical link and a virtual 
circuit. 

• List available programming facilities. 

• Identify the network layers involved in a task-to-task 
communication for: 

- DECnet 

- PSI 

- DLX 



A network manager must be able to: 

• Specify the basic features of the. Network Management Layer. 

• Identify the differences between: 

Down-line system loading and task loading 
Routing and nonrouting nodes 
Path length and path cost 
. - Circuit and line 
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RESOURCES 



1. DECnet-RSX Programmer's Reference Manual 

2. DECnet-RSX Guide to User Utilities 

3. DECnet-RSX Post-Installation and Checkout Procedures 

4. DECnet-RSX Release Notes 

5. DECnet-RSX System Manager's Guide 

6. DECnet-RSX Network Generation and Installation Guide 

7. Introduction to DECnet 

8. Overview of DECnet-RSX 

9. DECnet DNA (Phase IV) General Description 
10. RSX-11M/M-PLUS Executive Reference Manual 
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DECnet IMPLEMENTATIONS 

DECnet is: 

• An integral part or a layered product on top of the 
operating system (DECnet/M/M-PLUS/S is a layered product) . 

• A facility that connects various operating systems into a 
network. 

• An interface between an end user and a network. 
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Figure 1 DECnet Implementations - Interface Between 
Operating Systems and the Network 
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DECnet FUNCTIONS 

• Task-to-task communication 

• Network resource access 

File transfer 
File access 

• Network command terminal 

• Down-line system loading/up-line system crash dump 

• Down-line task loading/up-line task checkpointing/down-line 
task overlaying 

• Network management 

• Terminal communication 

• Direct line access 

• Routing 

• Local area networks 

• Multipoint 

• Packetnet System Interface 



> RUN RMT 

HOST: WASH 

CONNECTED TO "WASH," SYSTEM TYPE = RSX-1 1 M 

>HELLO CHARLES 



RSX-1 1M BL32 MULTI-USER SYSTEM 

GOOD AFTERNOON 

01 MAR-82 15:36 LOGGED ON TERMINAL HT3 

WELCOME TO SYSTEM "WASH" 

>FOR ADD,ADD=ADD 

>TKB ADD,ADD,ADD=ADD 

>RUN ADD 

TYPE TWO NUMBERS-M.N 

522,628 

THE SUM IS 1150 

HT3 - STOP 

>EXIT RMT 

> "* LOCAL NODE DENVER S 

PROMPT 




BOSTON:: 



COMMANDS 
PROCESSED 
HERE 



DENVER AND WASH 
ARE DECnet-RSX NODES. 

LEGEND 

PHYSICAL COMMUNICATION LINES 

LOGICAL LINK 



a 
o 

CD 

(T 

I 

m 
X 

o 

< 

< 
M 

m 
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Figure 2 Network Command Terminal Usage 
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OPERATOR 

AT 

NODE 

BEING 

LOADED 



EXECUTOR 
NODE 



SYSTEM 
MANAGER 



TK-4781 



Figure 3 Down-Line System Loading Using 
Network Management (NCP Interface) 
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DECnet LAYERS AND PROTOCOLS 

e Layers are defined in the DNA 



• 



Each layer is responsible for certain functions logically 
different from those supported by another layer 

Layers communicate across a network by exchanging messages 
according to the rules specified by a corresponding 
protocol 

Protocol is a set of formal rules representing a layer's 
logic and communication 

Protocol is transparent across a network 

Implementation of a layer, as described by a particular 
protocol, is logically transparent in a network 

Currently defined layers and corresponding protocols: 

User Layer — User-written protocol 
Network Management Layer — NICE protocol 

- Network Applications Layer — DAP protocol 
End Communications Layer — ECL Protocol 

- Routing Layer — Routing protocol 

T> _ J T.S_I- T _ r\T>/1»*T"k _ _ - J T 

- uaLd i-.j.ni\ Liayei uuv^nr piuiy^yi 

Physical Link Layer 
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COMMUNICATION IN A NETWORK 

• Horizontal communication — Communication between the same 
layers on different nodes (Figure 4) 

It is defined by a protocol's rules 

It is transparent across a network 

Protocol exchanges with control messages on a 
time/event basis 

• Vertical communication — Communication between different 
layers at the same node (Figure 5) 

It is dependent on implementation 

r /5 

- Data from the higher layer _are" "enveloped" by control 
information from the lower layer (s) before leaving the 
source node and "deenveloped" on the destination node 
(Figures 6 and 7) / 
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Figure 4 Horizontal Communication in a Network 
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O A USER PROGRAM 
COMMUNICATING 
WITH A REMOTE 
PROGRAM ON AN 
ADJACENT NODE 
VIA DLX 



THE NETWORK CONTROL 
PROGRAM, WHICH ALLOWS 
MANAGER/OPERATOR TO 
MONITOR/CONTROL 
NETWORK ACTIVITY VIA 
DECiwt & PSI 



o 



A USER PROGRAM 
COMMUNICATING 
WITH A REMOTE 
PROGRAM VIA 
DECmt&PSI 



A USER PROGRAM 
ACCESSING REMOTE 
FILES VIA OECntt 
8, PSI 



A USER PROGRAM 
COMMUNICATING 
WITH A REMOTE 
PROGRAM VIA PSI 
ONLY 



\ 



USER 
LAYER 



USER 
PROGRAM 



NCP 
UTILITY 



S 



USER 
PROGRAM 



USER 
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USER 
PROGRAM 



NETWORK 

MANAGEMENT 

LAYER 
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NETWORK 
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MODULE 
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LINK 
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LINE A'i 
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LINE B'l 
CONTROLLER 



■v 



LINECs 
CONTROLLER 
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Figure 5 Vertical Communication on a Network Node 
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Figure 6 Enveloping User Data by Protocols 
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PACKET 

HEADER 
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Figure 7 Data Flow from Node 1 to Node 3 
(DECnet Portion of the Network) 



DECnet-RSX OVERVIEW 

DECnet INTERFACES 

• User Interface (task-to-task communications, RMS) 

• Network Interface (routing, multipoint, Ethernet) 

User Interface 

• Logical link by using the End Communications Layer 

• Virtual circuit by using PSI 

• Direct line access by using DLX facility 

• User has full control over this interface 

Network Interface 

• User must be logged in under a privileged User 
Identification Code (UIC) to access this interface 

• It is primarily controlled by a network 
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NODE ALICE 



NODE BOB 



USER 



DECnet * 



DECnet < 



USER 



USER 



USER 




USER 



DLX 



DLX 



DECnet 



Figure 8 Task Interaction in a Network 



16 



DECnet-RSX OVERVIEW 



Logical Link 



• Virtual path between two user processes (tasks) in the 
network 

• It is logically full-duplex • 

• Flow control is provided by the ECL layer 

• User creates and accesses the logical link using a set of 
DECnet calls 

• Usually more than one logical link can be created in a user 
process (task) 

Virtual Circuit 

• Virtual path between two user processes (tasks) in the 
network 

• It is logically full-duplex 

• Flow control is provided by the PSI layer 

• User creates and accesses a virtual circuit using a set of 
PSI calls 

• Usually more than one virtual circuit . can be 
created/activated in a user process (task) 

Direct Line Access 

• It can be used in communications only between adjacent 
nodes 

• Usually it is used for some specific applications 
(down-line system loading, loopback testing, and so on) 

• User interface is simple, not sophisticated 
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Notes on Figure 8 



1. Consider six nodes — Alice, Bob, Charlie, Doug, Eugene, 
and Frank: 

• Nodes' Alice and Charlie are DECnet and PSI nodes 

• Bob is PSI node only 

• Doug and Eugene are DECnet nodes only 

• Frank is DLX node only 

2. Consider the following ten tasks (processes) — A, B, C, 
D, E, F, G, H, I, and J: 

• A and D — node Alice 

• B and I — node Doug 

• C and G — node Eugene 

• E and H — node Bob 

• F — node Charlie 

• J — node Frank 

3. A task can have more than one logical link and/or virtual 
circuit active at the same time (Notes 4 and 5) . 

4. Tasks with active logical links (DECnet) : 

• A (node Alice) < > B (node Doug) 

• A (node Alice) < > C (node Eugene) 

• F (node Charlie) < > G (node Eugene) 

5. Tasks with active virtual circuits (PSI): 

• F (node Charlie) < — > E (node Bob) 

• D (node Alice) « — > E (node Bob) 

6. Tasks I (node Doug) and J (node Frank) are DLX-only tasks. 

7. Task H (node Bob) is not a network task; the user 
accesses it by using the PAD facility. 
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DECnet-RSX OVERVIEW 



8. Data Circuit Terminating Equipment (DCE); Packet 
Assembler/Deassembler (PAD) facility, 

9. PAD allows the start/stop terminal to access the remote 
computer by using the Public Packet Switching Network 
(PPSN) . 

10. For connections that go by using the PPSN, the user is 
paying for the number of packets (amount of data) being 
transferred. For connections that go by using the 
telephone network, the user is paying for distance and 
time. 
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Logical Link Addressing 



NODE ALICE 
ECL 



©< 



LOCAL PORT 
ADDRESS 


REMOTE PORT 
ADDRESS 


123456 


314518 


216030 


503119 







NODE DOUG 
ECL 



©- 



LOCAL PORT 
ADDRESS 


REMOTE PORT 
ADDRESS 


314518 


123456 







NODE CHARLIE 
ECL 



©- 



LOCAL PORT 
ADDRESS 


REMOTE PORT 
ADDRESS 


097180 


031547 











NODE EUGENE 
ECL 



<C>- 

» 



LOCAL PORT 
ADDRESS 



503119 



031547 



REMOTE PORT 
ADDRESS 



216030 



097180 



Figure 9 Details of Logical Link Addressing 



Notes on Figure 9 

1. The names of the nodes and tasks correspond to the names 
in Figure 8. 

2. The logical link is identified by two port addresses 
assigned by ECLs during the establishing logical link 
procedure. 

3. Each port address is 16 bits long, so each logical link is 
identified by 32 bits. 
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Virtual Circuit Addressing 



NODE ALICE 
PSI 



DTE DCE DCE | DTE 



®-" 



LOCAL PORT 
ADDRESS 



211154 



LOCAL LOGICAL 
CHANNEL* 



16 



LEGEND: 

DTE - DATA TERMINAL EQUIPMENT 
DCE - DATA CIRCUIT TERMINATING 
EQUIPMENT 



DCE 



NODE BOB 
PSI 



LOCAL LOGICAL 
CHANNEL* 



LOCAL PORT 
ADDRESS 



160110 



300012 






DTE 



NODE CHARLIE 
PSI 



LOCAL LOGICAL 
CHANNEL* 



24 



LOCAL PORT 
ADDRESS 



901316 



~<E) 



Figure 10 Details of Virtual Circuit Addressing 



Notes on Figure 10 

1. The names of the nodes and tasks correspond to the names 
in Figure 8. 

2. The initiating side allocates a port and a logical channel 
number before sending a packet to a local DCE. 

3. When the packet arrives to a remote DCE, the DCE allocates 
a logical channel number and gives the packet to the 
remote DTE; the remote DTE then allocates a port. 

4. The virtual circuit is identified by the Logical Channel 
Numbers (LCNs) at each end. 
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DECnet-RSX OVERVIEW 

Typical DECnet Calls for a Logical Link 

• Requesting a logical link 

• Receiving a logical link request 

• Accepting or rejecting a logical link request 

• Sending data 

• Receiving data 

• Sending interrupt data 

• Receiving interrupt data 

• Terminating a logical link 

Typical PSI Calls for a Virtual Circuit 

• Requesting a virtual circuit 

• Receiving a virtual circuit request 

• Accepting or rejecting a virtual circuit request 

• Sending data 

• Receiving data 

• Sending interrupt data 

• Receiving interrupt data 

• Terminating a virtual circuit 

• Resetting a virtual circuit 

Typical DLX Calls 

• Controlling the line (open, close, hangup) 

• Sending a message 

• Receiving a message 



22 



DECnet-RSX OVERVIEW 



USER MODULE 



USER LAYER 



MCTW/nDi/MAMArcMCMTynniii c 

i\i_ i ilwim iyi/-iiM/-vO i-iviCi'* i iviuuull 



NETWORK 
MANAGEMENT LAYER 



NETWORK APPLICATION MODULE 



NETWORK 
APPLICATION LAYER 



SESSION CONTROL MODULE 



ECL MODULE 



SESSION CONTROL LAYER 



END COMMUNICATIONS 
LAYER 



XPT MODULE 



ROUTING LAYER 



X.25 MODULE (LEVEL 3) 



i PACKETNET 
SYSTEM 
INTERFACE 



DATA LINK MODULES 



DATA LINK LAYER 



PHYSICAL LINK MODULES 



PHYSICAL LINK LAYER 



Figure 11 Network Management Interface 
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yCECUTOR ft, 0o 



USING MOP. THE EXECUTOR 
SHIPS THE LOAD FILE TO THE 
TARGET NODE. THIS COMPLETES 
THE DOWN-LINE LOAD. 



USING NICE MESSAGES SENT OVER 
A LOGICAL LINK. NETWORK MANAGEMENT 
MODULES IN THE COMMAND NODE 
FORWARD THE REQUEST TO THE EXECUTOR. 




AN OPERATOR REQUESTS A 
DOWN-LINE LOAD TO A TARGET 
NODE FROM A REMOTE EXECUTOR 
NODE 



LEGEND: 

MOP - MAINTENANCE OPERATION PROTOCOL 

NICE - NETWORK INFORMATION AND CONTROL EXCHANGE 

NCP - NETWORK CONTROL PROGRAM 



Figure 12 Down-Line Loading Initiated by a Command Node 
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NODE BOS 



HOST: RSX DECnet/PSI 

(HLDTAB.MAC FILE CONTAINING HTASK$TLK) 




NODE STET 

SATELLITE: RSX-11S 



TERMINAL USER INPUT: 
>RUNTLK 



Figure 13 Down-Line Task Loading 
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ROUTING 
Types of Nodes 

• Routing IV node — A Phase IV node that allows for packets 
to be routed through its lines (route-through traffic); it 
communicates with a node of any type. lo ?.-i -v ^ 

• Nonrouting IV node — A Phase IV node that has only one 
physical line that connects it to the network; it does not 
allow for route-through traffic. It communicates with a 
routing or nonrouting node. »c~ - 

• Routing III node — A Phase III node that allows for 
packets to be routed through its lines (route-through 
traffic); it communicates with up to2=5»l nodes of any 
type. This node cannot be located on an Ethernet. 

• Nonrouting III node — A Phase III node that has only one 
physical line that connects it to the network; it 
communicates with ro uti ng or nonrouting nodes whose node 
addresses are below Ml .7-ttTh i s node cannot be located on an 
Ethernet. 



Figure 14 presents a possible topology for a DECnet network. 
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s~s 




LEGEND: 



f) = ROUTING NODE Q = NONROUTING NODE /\ - PHASE III NODE 



TK-4797 



Figure 14 Example of a Network Routing Topology 
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Routing Terminology 

• Hop — The logical distance between two adjacent nodes 

• Path — The route a packet takes from a source node to a 
destination node 

• Path length — The sum of hops along the path 

• Cost — An arbitrary integer value assigned to a circuit 

• Path cost — The sum of costs along the path 

• Reachable node — The destination node to which a usable 
path exists in a network 

Cost is used in the routing algorithm to determine the best 
path for a packet. The transport routes packets on the path of 
least cost, even if it is not the path with the fewest hops. 
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LEGEND. 

(x) = NODE 
= PHYSICAL LINE 




N 



= CIRCUIT COST 



<E> 



viz - 



NODE A WANTS TO SEND A PACKET TO NODE D. THERE ARE THREE POSSIBLE PATHS. 




PATH COST 


PATH LENGTH 


©TO©- ©I 10 © ©TO© 


Hl+[2] + [3]=7- 


3 HOPS 


0TO0.0 


[3 + 0=9 


2 HOPS 


© T0 © ©TO© ©TO©. ©TO© 


H]+H]+0+lH= 11 


4 HOPS 



' 7 IS THE LOWEST PATH COST; NODE A THEREFORE ROUTES THE PACKET TO NODE D VIA THIS PATH. 



Figure 15 Routing Terms 
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MULTIPOINT CAPABILITIES 

A multipoint line is a single communications line connected to 
more than two nodes." (A line connecting only two nodes is a 
point-to-point line.) 




CIRCUIT DMC-0 



LINE DMC-0 
POINT-TO-POINT CONNECTION 







(nycV 



CONTROL 
NODE 



LINE DMP-0 



CIRCUIT DMP-0.0 



LINE DMV-0 
CIRCUIT DMV-0 



CIRCUIT DMP-0. 1 



LINE DMP-0 
CIRCUIT DMP-0 



(man) 



© 



TRIBUTARY 1 



TRIBUTARY 2 



MULTIPOINT CONNECTION 



Figure 16 Circuits and Lines 



TK-8483 
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ETHERNET 

Ethernet is a local area network that provides a 
communications facility for high-speed data exchange among 
computers and other digital devices located within a moderately 
sized geographic area. It is intended primarily for use in such 
areas as office automation, distributed data processing f terminal 
access, and other situations requiring economical connection to a 
local communication medium carrying traffic at high-peak data 
r ate s « 



TRANSCEIVER CABLE. 




r 

| COAXIAL 



POINT-TO-POINT [} 

LINK (1000 M MAX) 



SEGMENT 5 



Figure 17 Typical Large-Scale Ethernet Configuration 
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EXERCISES 



1. Match the available network features to an appropriate 
product. Each item may be used once, more than once, or not 
at all. 



Features 

a. Ethernet 


Pr 

1. 


b. 


Down-line system loading 
(host) 


2. 


c. 


Network management 




d. 


Task-to-task communication 


3. 


e . 


Direct line access 


4. 


f . 


Network command terminal 




g. 


Remote task control 


5. 


h. 


Remote file access 




i . 


Multipoint 




J. 


Terminal communication 




k. 


Remote terminal access via 
X. 25 network 




1. 
m. 


File transfer 

PSN access via X. 25 




n. 


Down-line system loading 
(satellite) 





Products 

1. DECnet-llM, 
Version 4. 1 



DECnet-llM-PLUS, 
Version 2.1 

DECnet-llS, 
Version 4. 1 



4. RSX-11M PS I, 
Version 2.0 

RSX-11M-PLUS PSI, 
Version 2.0 
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2. Select the best answers for the following statements. 

1. The Ethernet Local Area Network is supported under 

a. Phase III DECnet 

b. Version 2.0 of PSI 

c. Phase III and IV implementations of DECnet 

d. None of the above 

2. Down-line system loading is used with: 

a. The Packetnet System Interface 

b. The RSX-11S operating system 

c. The communications server product 

d. Micro PDP-11 systems 

3. The DECnet-RSX product is considered a: 
a . Lavpred Droduct 

- 4 - t _--...■ - 

b. Part of the RSX-11 operating system 

c. Separate operating system 

d. All of the above 
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SOLUTIONS 



1* Match the available network features to an appropriate 
product. Each item may be used once, more than once, or not 
at all. 



Features 

a. Ethernet 1, 2, 3 

b. Down-line system loading 
(host) 1, 2 

c. Network management 1/2^31-4^,5, 

d. Task-to-task communication ,1,2,3,4,5, 

f. Network command terminal . 1, 2* 3 _ 

g. Remote task control jL, 2,3. . 

h. Remote file access 1.2.3 

i — 

i. Multipoint 1, 2, 3, , 

j. Terminal communication 1, 2, 3 , 

k. Remote terminal access via 
X. 25 network ,4, 5. 

1. File transfer 1, 2, 3 

m. PSN access via X. 25 4, 5 

n. Down-line system loading 
(satellite) J_ 



Products 

1. DECnet-llM, 
Version 4. 1 

2. DECnet-llM-PLUS, 
Version 2. 1 

3. DECnet-llS, 
Version 4.1 

4 S RSX-11M PS I, 
Version 2. 

5. RSX-11M-PLUS PSI, 
Version 2.0 
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2. Select the best answers for the following statements. 
1. The Ethernet Local Area Network is supported under 

a. Phase III DECnet 

b. Version 2. of PSI 

c. Phase III and IV implementations of DECnet 
(dTV None of the above 



2. Down-line system loading is used with: 

a. The Packetnet System Interface 
(bJ - The RSX-11S operating system 

(cT) The communications server product 
d. Micro PDP-11 systems 

3. Tne DECnet-RSX product is considered a: 
(aj) Layered product 

b. Part of the RSX-11 operating system 

c. Separate operating system 

d. All of the above 
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4. A DECnet-RSX node can exist in the following 
configurations: 

a. DECnet only 

b. PSI only 

c. DECnet and PSI 
-{dy- All of the above 

5. When user data from a DECnet task is sent over the PPSN, 
the following headers will be in the packet: 



(ay ECL header 

b, DDCMP header 

(c^ X. 25 Level 3 

(d) Routing header 
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INTRODUCTION 

This module presents the user interface in detail. 

The user interface for DECnet includes a set of utilities and 
programming facilities. Each utility described in this module is 
implemented as a pair of tasks (requester and server) that 
communicate by using a logical link. Any server task must be 
installed on the remote node before a requester can actually 
access it. 

The utilities discussed in this module are: 

• Terminal Communications (TLK) Utility — Allows the user to 
send single messages and text files to a remote terminal. 

• Network File Transfer (NFT) Utility — Provides functions 
such as accessing a directory located on a remote node, 
transferring files between nodes, executing a command file 
on a remote node, and so on. 

• File Transfer Spooler (FTS) Utility — Spools NFT-like 
requests to a local RSX-11 queue manager. The queue 
manager is responsible for giving such a network job to an 
FTS despooler, which establishes a logical link to a remote 
file access server. 

• Remote Command Terminal (RMT) Utility — Logically accesses 
the remote DECnet-llM/M-PLUS node as a terminal user. 



Programming facilities for DECnet include: 

• Task-to-task communication — A user creates his own 
requester and server tasks that establish a logical link to 
one another. Such a facility is also available for PS I 

(tasks create a virtual circuit rather than a logical link) 
and DLX (two tasks communicate with each other through a 
preassigned physical line). 

• Remote file access — A user creates only a requester task 
to communicate by using a logical link with the standard 
remote file access server. 

• Remote task control — A user writes a requester task to 
establish a logical link to a standard task control server. 
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OBJECTIVES 

To be successful with the user interface, the user must be 
able to: 

Use the command syntax for TLK, NFT, FTS, and RMT fluently. 

Identify key concepts for task-to-task communication 
programming for logical links and virtual circuits. 

List the languages supported for the interface. 

Interpret the programming examples in the reference 
literature. 

Program simple requester and server tasks for task-to-task 
communication over a logical link. 



RESOURCES 

1. DECnet-RSX Guide to User Utilities 

2. DECnet Programmer's Reference Manual 



Video Screen Dialogue 

To support the TLK video screen, the IO.WBT, 10. RPR and 10. ATA 
terminal functions must ail be supported by your target system. 
The video mode option need not be supported by the target node; 
the messages appear on the remote terminal like a normal dialogue 
session. 



SCREEN 1A 



NODE 1 



SCREEN 2A 



NODE 2 



HELLO N0DE2, ANY MESSAGES FOR US TODAY? 
IF SO LET US KNOW. 



| <TLK> DIALOGUE WITH N0DE2 TT4 






SCREEN IB 



NODE 1 



SCREEN 2B 



NODE 2 



HELLO NODE2, ANY MESSAGES FOR US TODAY? 
IF SO LET US KNOW. 



| <TLK> DIALOGUE WITH NODE2TT4 

YES, WE NEED ZEBRA FILES. 





| <TLK> DIALOGUE WITH NODE 1 TT3 

HELLO N0DE2, ANY MESSAGES FOR US TODAY? 
IF SO LET US KNOW. 



Figure 1 TLK Usage in Video Screen Dialogue Mode 
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Command File Support 

In Example 3: 

• The contents of TAPMOU.CMD are displayed on the local 
terminal if the Trace Switch (/TR) is specified. 

• Indirect command files are not supported by DECnet/S. 

>TLK @TAPMOU/TR 

TLK> N0DEA::TT2: 'MOUNT A DECTAPE PLEASE. 

TLK> TT4: 'THIS IS A LOCAL MESSAGE. 

TLK> NODEB:: 'TO NODEB 'S CONSOLE TERMINAL. 

Example 3 Executing the TLK Single Message Command File 
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In Example 4: 

• TLK allows you to execute two types of command files for 
dialogue mode messages: 

Command files that contain the actual list of dialogue 
messages 

- Command files that execute other command files 

• If a command file uses dialogue mode; dialogue mode is 
• nonvideo regardless of the terminal type. 



File DISTLIS.CMD contains the lines: 

NODER: :TT3: 
^NOVACAN.CMD 

File NOVACAN.CMD contains the messages: 

ALL MORNING FLIGHTS TO MULGRAVE, 
NOVA SCOTIA HAVE BEEN CANCELED 
CALL OUR CANADIAN OFFICE AFTER 
6 P.M. TO OBTAIN INFORMATION ON 
TOMORROW'S FLIGHTS. 

When executing DISTLIS.CMD, NOVACAN.CMD is also executed. 
Example 4 Executing the TLK Dialogue Command File 
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Command Switches 

TLK allows you to specify /TR for displaying the contents of a 
command file on the local terminal (Example 4). 

Exit with Status 

TLK exits with a status code that may be useful in these 
circumstances : 

• An indirect command file 

• A batch stream job (for RSX-11M-PLUS systems only) 

• When spawned by a parent task or connected to a parent task 

There are two exit status codes that TLK can issue: 

Status Code 

TLK exited 1 (EX$SUC) 

without error 

TLK exited 2 (EX$ERR) 

with an error 



NOTE 
If any command in an indirect command file 
fails, an exit with a status code 2 (EX$ERR) 
is issued when TLK exits. 



You can test the status code returned by TLK and, on the basis 
of the results, specify alternative procedures. 
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TLK Components 



NODE A NODE B 

LUUIUML LllNIV 




LEGEND: TLK - TERMINAL COMMUNICATION REQUEST TASK 

LSN - TERMINAL COMMUNICATION SERVER TASK (OBJECT 16) 



7K-8503 



Figure 2 TLK Utility Components 
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Network File Transfer (NFT) Utility 

• NFT features 

- Transfer files between two nodes 
Delete files on a remote node 

Execute command files stored on a remote node 

Transfer local command files to a remote node for 
submission to the remote command file processor or 
batch system for execution and subsequent deletion 

- List remote node directories 
Spool files to a line printer 
Append files to an existing file 

- Rename a file 

Change a file's protection status 

• Node specification 

• File specification 

Defaults 
Foreign files 
Wildcards 

• File transfer types 

Single-file transfer 

File transfer with concatenation 

Multiple-file transfer 

• Command switches 

• Exit with status 
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NFT Exarrfpies 

Examples 5 through 9 are explained individually on the 
following pages: 



NFT> NODEX/[200 f 30] /DECNET/1 0: :DT0: [40 f 10]MAGIC.MAC; 3' 
NFT> NODEY"DECNET DEMO M ::SY0: [DDPJMYSTIC.MAC ; 2 



Example 5 Single-File Transfer 

NFT> FAL. LOG=BERGIL/MIL/RITCH: : "MIL$DISK: FAL. L0G;2" 
Example 6 Single-File Transfer Using a Foreign File 



NFT> ELROND/FOO/BAR: :DB0: [100,1]=DM1: [*, 10]FIlC%. MAC 



Example 7 Multiple-File Transfer Using Wildcards 



NFT> WASH::DB0: [200, 200]NAMES. CMD/EX 
Example 8 Using the /EX Switch for Executing a Command File 



>NFT ^filename 
Example 9 Using a Command File Containing the NFT Command 
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_ Node Specification 

A node specification consists of the name of the node and 
optional access control information for that node, followed by two 
colons : 

nodename[access control]:: 

Access Control Information 

Access control information consists of three 

position-dependent fields appended to a node name and delimited by 
slashes (/) or spaces ( ): 

nodename/user id/passwd/ [accnt] : : 

or 

nodename"user id passwd [accnt]":: 

where : 

userid is a 1- to 16-character string identifying the 

user at the remote system 

passwd is a 1- to 8-character string password needed 

to gain access to the remote file system 

accnt is a 1- to 16-character string used to specify 

an account at the remote system. This is an 
optional parameter and only implemented on 
systems with accounting installed. 

Examples of valid node specifications appear as: 

ELR0ND/[7, 7] /SECRET/WORD: : 
SAM/5, 10/LEFT: : 
BOSS/EVERY/ONE:: 
HALDIR"DECNET F00" : : 
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File Specification 

• Defaults 

• Foreign files 
e Wildcards 

NFT commands operate on file descriptors that identify files 

in the network. A file descriptor consists of a node 

specification and a file specification. File descriptors are in 
the form: 

[node specification: :] [file specification] 

Depending upon its position in a command string, a file 

specification is either a source or a destination file 

specification. Furthermore, the node names define the file 

specification as local or remote. Therefore, NFT files can fall 
into four categories: 

• Local destination 

• Remote destination 

• Local source 

• Remote source 
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Table 1 Summary of DECnet-RSX NFT File 
Descriptor Defaults 



Field 



Conditions 



Default Value 



nodename The file is the first or 

only file in the input list 
or the output list. 

The file is a subsequent 
file in a given list. 



userid Userid is preassigned 

using an alias node name. 



A node name with access 
control information is spec' 
ified to NFT using the 
Default Switch (/DF) . 

passwd The passwd value is pre- 

assigned using an alias 
node name. 



Local node name. 



Preceding node name 
specified in the list 
(including access 
control information) . 

Userid value specified 
with the alias node 
name. 

Value of userid given 
for the node name. 



Passwd value specified 
with the alias node 
name. 



A node name with access 
control information is spec- 
ified to NFT using the /DF 
switch. 



Value of passwd given 
for the node name. 



accnt 



The accounting number is 
preassigned using an alias 
node name. 



Accnt value specified 
with the alias node 



name. 



A node name with access 
control information is 
specified to NFT using 
the /DF switch. 



Value of accnt given 
for the node name. 
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Table 1 Summary of D£Cnet~RSX NFT File 
Descriptor Defaults (Cont) 



Field 



Conditions 



Default Value 



dev 



The file is the first or 
only file in an input list 
or an output list associated 
with a particular node. 



SY device associated 
with the access control 
given with the specified 
node name. If no node 
name is given, it defaults 
to the user's current SY 
device. 



The file is a subsequent file 
in a given list, as previously 
defined . 



Preceding device 
specified in the list. 



uic 



A device is specified to NFT 
using the /DF switch. 

The file is the first or the 
only file in an input list or 
an output list associated 
wi tii a particuxar nou 6 . 



Device specified in the 
/DF command . 

Uic associated with the 
access control given 
with the specified node 
name. If no node name 
is given, it defaults 
to the user's current 
Uic. 



filename The file is the first or 

only file in the input list. 

The file is a subsequent file 
in the input list. 

The file is an output file. 



type 



The file is the first or 
only file in the input list. 

The file is a subsequent 
file in the input list. 

The file is an output file. 



None 



Preceding file name 
specified in the list. 

Name of the correspond' 
ing input file. 

None 



Previous type specified 
in the list. 

Type of corresponding 
input file. 
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Table 1 Summary of DECnet-RSX NFT File 
Descriptor Defaults (Cont) 



Field Conditions Default Value 

ver The version number is Highest version of 

omitted for any input file. file. 

The version number is If a file name or type 

omitted for any output file. was specified for the 

output file, the 
highest version number 
is used. 

If no file name or type 
was specified for the 
output file, the 
version number of the 
corresponding input file 
is used. 
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Foreign Files 

Files that reside on non-RSX nodes are referred to as foreign 
files. Since foreign files must use syntax that is compatible 
with the systems on which they are located, the file specification 
should be enclosed in double quotes (" ") . This directs NFT to 
transmit the file specification to the foreign node without 
checking its syntax or applying defaults for missing fields. Note 
that using double quotes may also be used to override defaults. 

For example, the following command line causes a file transfer 
from a VAX node to the local node. You must specify an output 
file name, since NFT does not decode the input file name when 
surrounded by quotes. 

NFT> ZOOK"RYAN FOOBAR" : : =NANOOK: : " SYS $S YSROOT: [SYSMGR JACCOUNT. DAT; 2" 

Example 10 One-File Transfer Using a Foreign File 
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Wildcards 

An asterisk inserted in a field means that any value is 
accepted within that field. Allowable wildcard field specifiers 
are listed. 

In addition, NFT permits wildcard specifiers for part of a 
field in the file name and file type, as defined: 

1. An asterisk (*) in a portion of a field means that part of 
the field can be replaced with any characters of any 
length (including none). Examples are: 

SOME*. TYP will accept: SOME. TYP 

SOMETHG.TYP 
SOMEBODY. TYP 
SOMEBZ.TYP 



2. A percent sign (%) in a character position means that any 
one character is accepted in that position (nulls are not 
permitted). Examples are: 



MAIL%. MAI will accept: MAIL1.MAI 

MAIL2.MAI 
MAILX.MAI 

IMV%I%%. TXT will accept: IMV1I22.TXT 

IMV2I30.TXT 
IMV3I45.TXT 



NFT> ELROND/FOO/BAR: :DB0: [100,l]=DMl: [* , 10]FIL%%. MAC 
Example 11 File Transfer Using Wildcards 
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Fife Transfer Types 

• Single-file transfers 

• File transfer with concatenation 

• Multiple-file transfer 



NFT> NODEX/[200, 30] /DECNET/1 0: :DR0: [40, 10]MAGIC.MAC ; 3 = 
NFT> NODEY/200,10/PASME/10: : SY0: [3 0, 60 ]MYSTIC. MAC ; 2 



Example 12 Single-File Transfer 



NFT> NODEA::DRl: [50, 10JSUM . TIM=NODE Y: : DK0: [50,10] 
NFT> SAM. LIT, ONE. WAY 



Example 13 File Transfer with Concatenation 



NFT> NODEA: : =NODEB/ [3-00, 501 /MULT I: :- 
NFT> DY0:BEE.FIL/AS,CEE.FIL,DEE,FIL 



Example 14 Multiple-File Transfer 
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Command Switches 

Table 2 Summary of NFT Switches 
Switch Description 

/AP The Append switch permits files to be added to the 

end of an existing file. 

/AS The ASCII Record Mode switch causes NFT to transfer 

a file in ASCII record mode. 

/AT The Attributes switch causes a directory to be 

listed that contains file names and specific 
attributes associated with each file. 

/AX The Automatic Transfer switch causes NFT to use its 

default algorithms in selecting the mode to transfer 
a file to a remote node. 

/BK The Block Mode Transfer switch. 

/BR The Brief Listing switch causes a directory to be 

listed that contains only the names of files on a 
node. 

/DE The File Deletion switch allows you to delete 

one or more files. 

/DF The Default switch allows you to set certain 

default values for source and destination files. 

/EX The Execute switch causes a command file stored on 

a remote or local node to be executed. 

/FU The Full Directory Listing switch causes a full 

directory to be listed for files on a remote node. 

/HE The Help switch causes a descriptive message about 

NFT switches, subswitches, and commands to be 
d isplayed . 

/ID The Identify switch causes the version of NFT to transfer 

a file in image record mode. 

/IM The Image Record Mode switch causes NFT to transfer 

a file in image record mode. 
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Table 2 Summary of NFT Switches (Cont) 



Switch Description 



/LI The Listing switch causes a directory to be listed that 

contains the name- size- date of creation* and 
contiguous indicator of files on a remote node. 

/LO The Log switch is a qualifying switch that causes 

the names of files (copied, deleted, and so on) to 
be displayed as the operation is performed. 

/NV The New Version switch specifies that an output file 

will have the same or latest version number, 
whichever is higher. 

/PR The Protection switch allows a file's protection 

status to be set or changed. 

/QU The Query switch is a qualifying switch that questions 

you regarding each file operation in a command. 

/RC The Record Mode Transfer switch directs NFT to transfer 

a file one record at a time, instead of using block mode 

/RE The Rename switch allows the name of a file to be 

changed. 

/SB The Submit switch causes a command file to be submitted 

for execution on a local or remote node. 

/SP The Spool switch causes files to be spooled to a line 

printer for printing. 

/SU The Supersede switch allows the contents of an existing 

file to be replaced with new input and a new file ID, 
while retaining the existing name and version number. 
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Exit with Status 

NFT exits with a status code that may be useful in these 
circumstances: 

• An indirect command file 

• A batch stream job (for RSX-11M-PLUS systems only) 

• When spawned by a parent task or connected to a parent task 

There are two exit-wi th-status codes that NFT can issue: 

Status Code 

NFT exited 1 (EX$SUC) 

without error 

NFT exited 2 (EX$ERR) 

with an error 



A status code of 2 (EX$ERR) is returned whether you incur a 

syntax error or an operational error. Also, if any command in an 

indirect command file fails, an exit-wi th-status code of 2 
(EX$ERR) is issued when NFT exits. 
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NFT Components 



NODE A 



NODEB 




LEGEND: NFT- NETWORK FILE TRANSFER REQUESTTASK 

FAL- NETWORK FILE TRANSFER SERVER TASK (OBJECT 17) 

NVP - NETWORK VERIFICATION PROCESSOR TASK (CHECKS INCOMING 

REQUESTS FOR VALID ACCOUNTS AND PASSWORDS BEFORE GIVING 

THEM TO FAL) i^ - ~~ 



Figure 3 NFT Utility Components 
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File Transfer Spooler (FTS) Utility 

• FTS features 

FTS has a set of file transfer and manipulation 
capabilities that are the same as those provided by NFT: 

Transfer files between two nodes 

Delete files 

Execute command files stored on a remote node 

Spool files to a line printer 

Append files to an existing file 

Transfer local command files to a remote node for 
submission to the remote command file processor, 
execution, and subsequent deletion 
^ CO S~ 
° v. > In addition, FTS provides the following control 

1 •* S runctions not available in NFT: 

Queue and process user requests according to 
user-supplied dates and times 

List pending user requests 

Kill pending user requests 

Log user request completion 

• Node verification 

• File specification 

• File transfer types 

Single-file transfer 

File transfer with concatenation 

Multiple-file transfer 

• Command switches 

• Function codes (/LI switch) ^ f ,_ - t v.«ur.. 

• Completion return (/LO switch) 
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FTS Features 

FTS> =DENVER: :DR2: [2 00, 200]INVENTORY. LST? 4 
Example 15 Simple Transfer Request from a Remote Node 



FTS> DALLAS:: /LI 

FTS> USER REQUEST LISTING 2S-Jun-30 11:30 

Job $ Type/Priority Options 

141S54 TLR/50 /IM/LQ 

Queued 23-Jun-80 10:45 Active 

Source File - DBO: [224,1] FICA.LST?! 

Destination File - DALLAS: rDKl: [200,200] TAXES. LST 

382377 TLR/50 /AF:28-Jun-80: llr35AIM/L0 

Queued 23— Jun-S0 10:50 Tried 1 Time 

Source File - DBO: [224, 1] STATE. LST; 1 

Destination File - DALLAS: :DX1: [200, 200] TAXES. LST 

Log File - DSO: DALLAS. LOG 

Example 16 Print User Requests Involving a Specified Node 
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Command Switches 

Table 3 Summary of FTS Switches 

Switch Description 

/AF* The After switch permits a user request to be 

executed after a specified date and time. 

/AP The Append switch permits files to be added to the 

end of an existing file. 

/AS The ASCII Record Mode switch causes FTS to transfer 

a file in ASCII record mode. 

/DE The File Deletion switch allows you to delete 

one or more files. 

/DF The Default switch allows you to set certain 

default values for source and destination files. 

/ED* The Edit switch inhibits queuing of user requests 

for the current user. 

/EX The Execute switch causes a command file stored on 

a remote or local node to be executed. 

/HE The Help switch causes a descriptive message about 

FTS switches, subswitches, and commands to be 
d isplayed . 

/ID The Identify switch causes the version of FTS to 

transfer a file in image record mode. 

/IM The Image Record Mode switch causes FTS to transfer 

a file in image" record mode. 

/KI* The Kill switch causes a request to be removed from 

the FTS queue. 

/LI* The Listing switch causes any pending user requests 

to be listed. 

/LO* The Log switch causes a completion message to be 

logged for a serviced request. 
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Table 3 Summary of FTS Switches (Cont) 



Switch Description 



/PR* The Priority switch causes a specified priority to be 

assigned to the user request, 

/SB The Submit switch causes a command file to be submittei 

for execution on a local or remote node. 

/SE* The Sequence switch causes FTS to process command 

lines in the order they are input. 

/SP The Spool switch causes files to be spooled to a line 

printer for printing. 

* Switches supported by FTS that are not supported by NFT or 
that have functions different from those of NFT. 
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Function Codes (/LI Switch) 

Table 4 Summary of FTS Function Codes 

Function . 

Code Description 

CLL Concatenate local files to a local file. 

CLR Concatenate local files to a remote file. 

CRL Concatenate remote files to a local file. 

CRR Concatenate a remote file to a remote file. 

DL Delete file(s) on a local node. 

DR Delete file(s) on a remote node. 

EL Execute command file(s) issued for the local 

node. 

ER Execute command file(s) issued for a remote 

node. 

PL Print a file on the local node. 

PR Print a file on a remote node. 

SLL Submit a command file from the local node to 

the local node. 

SLR Submit a command file from the local node to 

a remote node. 

SRL Submit a command file from a remote node to 

the local node. 

SRR Submit a command file from a remote node to a 

remote node. 

TLL Transfer local file(s) to local file(s) . 

TLR Transfer local file(s) to remote file(s) . 

TRL Transfer remote file(s) to local file(s) . 

TRR Transfer remote file(s) to remote file(s). 
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Completion Return (/LO Switch) 

The Log switch causes FTS to return a completion message into 
your file area after processing your ' request . (A separate message 
is logged for each file in a multiple file transfer.) FTS logs 
completion messages as a network generation default and stores 
messages in a user log file. The /LO switch allows you to 
redefine the user log in which messages are to be placed. 

In Example 18, the first command logs a message by default and 
uses the default user log file specification, SY0: FTSSYS. LOG. The 
next command defines the user log file with the specification 
PAYR0LL.LOG. The third command line suspends logging for this 
request only with the /NOLO switch. The fourth and fifth commands 
illustrate the use of logical device names in the user log file 
specification. FTS directs the completion message to the console 
pseudodevice (CO:) in the fourth command and to the user's 
terminal (TI: ) in the fifth command. 



FTS> =DALLAS: :DR1: [2 00, 200JTAXES. LST 

FTS> DENVER: :SY0: [200, 200]=PAYROLL. CBL, . LST/LO: PAYROLL. LOG 

FTS> BOSTON: :DR0: [200, 200]=MISC. DOC ; 4/N0L0: 

FTS> GENEVA: :DU0: [100, 100]NEWSOFT.MAC=RELEASE.MAC/LO:'CO: 

FTS> LONDON: :DB2: [1 00, 100]=REALTIM.MAC/LO: TI: 



Example 17 Using the /LO Switch 



Example 19 illustrates a completion message for a 
remote-to-remote transfer that terminated in an error. The error 
code, N03407, indicates that the network rejected the connection 
(see Section 4 of the DECnet-RSX Guide to User Utilities for 
additional information on /LO error returns) . 

FTS> BOSTON: :DL2: [224, 223 ]=DENVER: : DU0: [200, 1 ]PEN. INV 

BOSTON TRR JOB =2 1752 6 

Time: 05-AUG-83 10:56:02 11:20:32 

USER: [200,1] Blocks:0 

Status: Error=BOSTON N03407 Discarded 

File: BOSTON: : DL2: [224, 223]PEN. INV 

INPUT: DENVER: :DU0: [200, 1]PEN. INV 

Example 18 Remote-to-Remote Transfer 
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KRYPTN 
Time: 
User : 
Status 
File: 
Input : 

BERGIL 
Time: 
User : 
Status 
File: 
Input : 



TRL Job=344533 

3-AUG-83 13:56:02 to 14:10:32 

[305,524] Blocks:368. 

Success 

DB2: [305, 324]FOUND.MEM 

KRYPTN: :USER: [RYAN] FOUND. MEM 

TRL Job=446415 

3-SEP-83 1:02:03 to 1:10:32 

[305,524] Blocks:87. 

Error = BERGIL 040040 Discarded 

BERGIL:: [ARGUS ] PLAN. DOC 

DB0: [305, 324]PLAN.DOC 



FTS Components 



Example 19 FTSSYS.LOG File 



SYSTEM MANAGER 
± 




FA L. LOG 
(OPTIONAL) 



LEGEND 

FTQ - FTS QUEUE MANAGER 

FTS - FTS REQUESTER TASK 

QMG - RSX-11M/M-PLUS QUEUE MANAGER 

FTSDEQ - FTS DESPOOLER 

URB - FTS USER REQUEST BLOCK 

FAL - REMOTE FILE ACCESS SERVER TASK 



Figure 4 FTS Components 
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Network Command Terminal (RMT) Utility 

RMT Features 

• Logically connects a terminal to a DECnet/M/M-PLUS node 

( hr\ e+- \ 

• QIO functions supported for RMT on a host 

Example 20 shows the designated file directory from the host 
node on your terminal. 



> 

>RMT 

Host: ELROND 

Connected to "ELROND", System type = RSX-11M-PLUS 
System ID: DISTRIBUTED SYSTEMS 



>HEL RYAN 
Password: 

RSX-11M-PLUS V2.1 BL15 [1,54] System ELROND 

07-NOV-83 11:10 Logged on Terminal HT0: 

Good Morning 



>PIP 
PIP> /LI 

Directory DB0: [305,330] 
7-NOV-83 11: 10 

MAIL.TMP;4 11. 28-DEC-82 14:45 

Total of 11. /ll. blocks in 1. file 

PIP>~Z 
> 

Example 20 Invoking and Running RMT 
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RMT handles most control characters (CTRL/0, CTRL/S, CTRL/Q, 
and CTRL/R) according to standard RSX-11 conventions. However, 
CTRL/C causes RMT to prompt for input (RMT>) and then pass to MCR 
on the host system. This procedure differs from conventional 
RSX-11 usage where CTRL/C directly initiates a local CLI prompt 
(for example, MCR>) . 

>MAC @FOOBLD 

CTRL/C 

RMT>ACT 

. . .SYS 

...MCR 

ACTH3 

MACH3 



Example 21 CTRL/C Handling by RMT 

When you finish remote terminal operations, type BYE to log 
off the host system. Typing BYE automatically disconnects you 
from the host node and returns control to the local operating 
system. (If you wish to stay connected to the host node, you can 
specify BYE/HOLD. You then have to type EXIT RMT to disconnect 
from the host.) 



>BYE 

> 

Have a good afternoon 

05-OCT-83 13:10 HT2: Logged off ZIRCON 

RMT — Control returned to node _CASTOR:: 

> 

Example 22 Exit from RMT Session 

If your terminal is externally forced to log off the local 
system without exiting from the RMT task first, RMT terminates 
your connection with the host node. 
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Table 5 QIO Functions Supported for RMT oh a Host 



Function 



Description 



Comment 



Standard Functions 



10. ATT 
IO.DET 



Attach device 
Detach device 



On TT: drivers, ATT and 
DET occur synchronously 
without fail. On HT: 
drivers, there is a time 
lag across the network, so 
you must specify an event 
flag to ensure that the 
task is synchronous with 
the function. Check for 
error returns; failures 
can occur. 



IO.KIL 



Cancel I/O requests 



Same as for TT: driver. If 
the connection is aborted, 
it may be because the host 
system is low on DSR (pool) . 



IO.RLB 



Read logical block 
( read typed input 
into buffer) 



Same as for TT: driver. 



neaa virtual diock 
(read typed input 
into buffer) 



Sub function bits are not 
cleared as they are with 
TT: drivers. 



IO.WLB 



Write logical block 
(print buffer contents) 



Same as for TT: driver. 



IO.WVB 



Write virtual block 
(print buffer contents) 



Subfunction bits are not 
cleared as they are with 
TT: drivers. 



Device-Specific Functions 



10. ATA 



Attach device; specify 
unsolicited input 
character AST 



See previous comments for 
10. ATT. 



10. CCO 



Cancel CTRL/0 (if in 
effect; then write 
logical block) 



Same as for TT: driver. 
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Table 5 QIO Functions Supported for RMT on a Host (Cont) 



Function 



Description 



Comment 



SF.GMC 



10. GTS 
IO.RAL 

IO.RNE 

10. RPR 

IO.RST 

IO.RTT 
SF.SMC 



IO.WAL 



IO.WBT 



Get multiple 
characteristics 



Get terminal support 

Read logical block; 
pass all bits 

Read logical block; 
do not echo 

Read logical block 
after prompt 

Read logical block 
ended by special 
terminators 

Read logical block 
ended by specified 
special terminator 

Set multiple 
characteristics 



Write logical block; 
pass all bits 

Write logical block; 
break through any 
I/O conditions at 
terminal 



Refer to the RSX-11M 
M-PLUS I/O Drivers 
Reference Manual for 
details. 

Same as for TT: driver. 

Same as for TT: driver. 

Same as for TT: driver. 

Same as for TT: driver. 

Same as for TT: driver. 

Same as for TT: driver. 



Refer to the RSX-11M/ 
M-PLUS I/O Drivers 
Reference Manual for 
details. 

Same as for TT: driver. 



Same as for TT: driver 
except that a WBT message 
may be broken into two or 
more pieces. For example, 
if a BRO program on the 
host writes a WBT message 
while you are typing 
input, the message may be 
broken into pieces (and 
your input will be retyped 
between pieces) . 
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RMT Components 



LOCAL 



HOST 



TERMINAL 





RMT 
















1F 










SYSTEM 


















RMTACP 






RMHACP 


•4 — 


HT: 
















































USER 














TASK 



LEGEND: RMT - REMOTE "M/M-PLUS" TERMINAL REQUEST TASK 
RMTACP - LOCAL REQUEST PROCESSOR TASK 
RMHACP - HOST SERVER TASK (OBJECT 23) 
HT: - NETWORK COMMAND TERMINAL DRIVER 



Figure 5 RMT Components 



TK-5255 
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PROGRAMMING 
Key Concepts 



Task-to-task communications requires two tasks, one on the 
local computer and one on the remote computer. The 
programmer must write both tasks. 

Remote File Access requires the user to write only one 
task. The task links the Network File Access Routines 
(NFARs) into the user task image. The File Access Listener 
(FAL) is the remote task the user task communicates with. 
Even the local files can be accessed using NFARs. 

Task Control also requires the user to write only one task. 
The task links the Task Control Subroutines to talk to the 
Task Control Listener (TCL). A remote task can be run, 
scheduled at periodic intervals, aborted, and the 
scheduling canceled. 

Direct Line Access provides a direct interface to the Data 
Link Control Protocol (DDCMPJcm and the driver. This is 
useful if all the routing, flow control, multiplexing, 
functionality, and so on are not needed. Flow control and 
routing, provided by the Routing and the End Control layers 
are not required. The user must write two tasks talking at 
both ends of the line directly. 

The Packetnet Switching Interface (PSI) provides only a 
task-to-task communication facility. The user must write 
both tasks. 
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DECnet-RSX Intertask Programming Concepts 

Intertask communications concepts include: 

• Assigning Logical Unit Numbers (LUN) 

• Establishing an active network task 

• Building a connect block 

• Establishing a logical link 

• Getting data from the network data queue 
i • Sending and receiving messages 

{; • Sending interrupt messages 
^ • Terminating activity on a logical link 
^ • Closing a network connection 

Assigning Logical Unit Numbers 



The following calls use a LUN assigned to the network data 



queue (MAILBOX): J ^,^ -- - ' ' " ' 



OPN$ Access the network 

SPA$ Specify a user AST routine 

GND$ Get network data 

REJ$ Reject a looical link reouest 

CLS$ End a task's network operations 

GLN$ Get local node information 



You can assign the LUN by defining it either as the global 
symbol .MBXLU in your program or as a parameter for the macro 
call. The e MBXLU definition and the macro call parameter 
definition are mutually exclusive (.MBXLU is referenced only if 
the LUN argument is left blank in the macro parameter block) . 



NOTE 
You should define a particular network data 
queue LUN in one place only. 
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If you use the .MBXLU definition, assign the LUN at assembly 
time or at task build time using one of the following command 
techniques : 

• To include the LUN locally in your source code, include the 
following in each source module: 

.MBXLU=x 
The variable x is an integer representing the LUN. 

• Each source module in the user task must have the same 
integer x defined for .MBXLU; otherwise, the macros will 
complete with a privilege error (IE.PRI). A programmer can 
define a global definition (==) by including the following 
statement in a single source module: 

.MBXLU==x 

This statement causes the task builder to define references 
to .MBXLU in all modules of the program to the value x. 

• If you want to defer definition of .MBXLU to task build 
time, issue the following task build option: 

GBLDEF=.MBXLU:x 

This option instructs the task builder to define all global 
references to .MBXLU as the value of x. 

These three command techniques for defining .MBXLU are 
mutually exclusive. If you do not use any of these procedures, 
the task builder returns an undefined reference warning message. 
If you run the task and ignore the warning, the six macro calls 
(OPN$, SPA$, GND$, REJ$, CLS$, and GLN$) will be rejected by the 
operating system with a directive status error indication an 
invalid LUN. The task builder causes undefined references to 
default to 0. .MBXLU cannot be defined with a value because 
is an invalid LUN. 



All network LUNs are released and the task's logical links are 
aborted when you issue a CLS$ call to terminate network operations 
for a MACRO-11 task. The CLS$ call can be issued in any of the 
three CLS$ formats - CLS[W]$, CLS[W]$E, and CLS[W]$S. 

If a LUN is not assigned to NS , any network directive will be 
returned with a status of illegal function code. 
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Establishing an Active Network Task 

Before any task can exchange data using intertask 
communication calls, the task must be an active network task. A 
task is active if it is running and it has issued an open (OPNx) 
call. An OPNx call establishes a network data queue for a task 
and connects the task to the network. 

Building a Connect Block 

Before the source task can issue a request to connect to 
another task, it must build a connect block. A connect block 
contains a destination descriptor, a source descriptor, access 
control information, and (optional) user-supplied data. 

Destination Descriptor 

When one task communicates with another task, the tasks are 
considered to be two objects communicating. There are two kinds 
of objects: named objects and numbered objects. T he de stination 

descriptor . id entif i.e s„ fche d es t i n a t i on. ,ta is Jk .eLthex ^bY^^s k n am e "o f 

by o b j ec t tyg e n um be r . „ . 

Najned___pjD j ec ts_ are installed user-defin ed ta s.ks.. ..that a r e 

referenced by name "When" ^'ljp7nl^Ptloji'\"isr requested.. The object 
"type numeric TcTerTElTTeY^for user tasks referred to by name is 0. 

N u m b e r ed obj ec t s are _in^alj.^d___us^x-(3e fined tasks and 
installed DECnet ta"skV'"tHait" are referred to by object type number 

whe n a c b nnectlTfn"" is requested*. Th e obj ec t type n urn e r i c 

identifier for these tasks referred to by number ranges from 1 to 
255. Numbers 1 to 127 are reserved for DECnet tasks. Numbers 128 
to 255 are- reserved for user tasks. See Table 6 for more 
information about object definitions. 
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Table 6 Object Types 



Object Type 



Octal 


Decimal 


000 


000 


001 


001 


002 


002 


003 


003 


004 


004 


005 


005 


006 


006 


007 


007 


010 


008 


011 


009 


012 


010 


013 


011 


014 


012 


015 


013 


016 


014 


017 


015 


020 


016 


021 


017 



Process Type 



General task, user process * 

File Access Listener (FAL/DAP), Version 1 

Unit Record Services (URSs) 

Application Terminal Services (ATS) 

Command Terminal Services (CTS) 

RSX-11M Remote Task Control (TLC) 
Utility, Version 1 

Operator services interface 

Node resource manager 

IBM 3270-BSC Gateway 

IBM 2780-BSC Gateway 

IBM 3790-BSC Gateway 

TPS application 

RT-11 (CTS-300) Dibol application 

TOPS-20 terminal handler 

TOPS-20 remote spooler 

RSX-11M Remote Task Control (TLC) 
Utility, Version 2 

TLK Utility (LSN) 

File Access Listener (FAL/DAP), 
Version 4 or later 



♦Descriptor Format .= 1 
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Table 6 Object Types (Cont) 



Object Type 



Octal 


Decimal 


022 


018 


023 


019 


024 


020 


025 


021 



026 

027 
030 

031 



77 



Process Type 



022 

023 
024 

02 5 



RSX-11S Host Loader (HLD) Utility 

Network Information and Control Exchange 
(NICE) 

RSTS/E media transfer program (NETCPY) 

RSTS/E-to-RSTS/E network command 
terminal handler 

Mail listener (DECnet-based electronic 
mail system) 

Network command terminal handler (host side) 

Network command terminal handler 
(terminal side) 

Loopback Mirror (MIR) 

Event Receiver (EVR) 

VAX/VMS personal message utility 

File Transfer Spooler (FTS) 

PHONE utility 

Distributed Data Management Facility (DDMF) 

X. 25 Gateway access 

Reserved for DECnet use 

DECnet Test Tool (DTR) 

Reserved for DECnet use 

Reserved for customer use 



032 


02 6 


033 


027 


034 


028 


035 


029 


03 6 


030 


037 


031 



040-076 032-062 



63 



100-177 064-127 
200-377 128-255 
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Source Descriptor 

The source descriptor contains information supplied by the 
DECnet software on the source node. The source descriptor 
contains the source node name and either the source object number 
or the source task name if it is a named object. The target task 
can use this information to determine if it wants to establish 
communications. 

Access Control Information 

Access control information contains arguments that define the 
user's access rights at the remote node. Access control 
verification is performed according to the conventions of the 
target system. If the target node is equipped to do so, it 
verifies access control information before the connect request is 
passed to the target task. 

Table 7 Verification Options 

Verification 

Option Meaning 

ON Verifies the source program's user identification 

and password against the node's system account 
file. If there is not an exact match, the connect 
request is rejected. The target program does not 
receive the request. 

INSPECT Verifies the source program's user identification 

and password just as for the ON option, except 
that the connect request is forwarded to the 
target program regardless of the outcome. The 
verification module tells the target program 
whether or not the source program checked out 
against the account file. 

OFF Does not verify. The target program receives all 

connect requests. 

NCP> SET OBJECT 135 NAME F00$$ 

NCP> SET OBJECT 135 VERIFICATION INSPECT 

Example 23 Declaring a Task as a Network Object and 
Turning on Access Verification for that Object 
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Optional Data Messages 

When the source task issues a connect request, you can include 
a data message of up to 16 characters in the connect block. If 
the Connect (CONx) call contains the location and length of a 
block of user data, the source node appends that block to the 
connect block. 

Establishing a Logical Link 

To exchange data, a logical link must be established between 
two active network tasks. A logical link is a path between two 
cooperating tasks. These tasks must agree to communicate. When 
the link is established, a user task can send and receive 
messages. 

The task requesting to establish a logical link is called the 
source task. The other task is called the target task. This 
distinction applies only during the connection sequence. Once the 
logical link is established, the terms source and target have no 
significance, since both tasks have equal access to the logical 
link. 

Tasks at either end of the link must specify a LUN for the 
link. The LUN is the number each task assigns to the logical link 
so that the link can be associated by the tasks and the network. 
The tasks at both ends of the link do not have to use the same LUN 
for a link. 
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Getting Data from the Network Data Queue 

Once the task is connected to the network, it has a network 
data queue. The software on the connected task's node places all 
incoming connect request messages, interrupt messages user 
disconnect messages, user abort messages, and network abort 
messages on the task's network data queue. To get these messages, 
the task must issue a Get Network Data (GNDx) call. A task should 
begin monitoring its network data queue as soon as the open call 
is completed successfully. 

The GNDx call ordinarily returns the first message in the 
queue on a first-in, first-out basis. However, the GNDx call has 
the following options: 

• Remove the first message on the queue and place it in the 
message buffer. 

• Remove the first message of a specified type for any 
logical link and place it in the message buffer. 

• Remove the first message of a specified type for a 
specified logical link and place it in the message buffer. 

• Determine the type, length, and associated logical link or 
any message on the queue without removing it from the 
queue. This allows you to assign an appropriate buffer 
size in a subsequent GNDx call that performs one of the 
four options. 
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Sending and Receiving Messages 

Once a logical link has been established between two tasks, 
both tasks can send and receive messages. DECnet distinguishes 
between data and nondata messages. Data messages are delivered 
directly to a buffer provided by the receiving task. Nondata 
messages are unsolicited high priority messages that inform the 
receiving task of some event such as an interrupt or disconnect 
request. 

To send a data message, a task issues a Send (SNDx) call. In 
the send call, specify the LUN assigned in the connect or accept 
call. Also specify the location and length of the data message 
buffer. A send call completes when the receiving node 

acknowledges to the sending node that it received a message 
correctly. 

To receive a data message, a task issues a Receive (RECx) 
call. In the receive call, specify the LUN assigned in the 
connect or accept call. Also specify the location and the length 
of the data message buffer. A receive call completes when the 
data message is placed in the specified data message buffer. If 
the data message buffer is not large enough, the receive call 
completes with a data overrun condition and excess data is lost. 
In the case of overrun, the I/O status indicates this. To receive 
the next data message, another receive call is required. 

To send high priority nondata message, a task issues an Abort 
(ABTx) , Disconnect (DSCx) , or Interrupt (XMIx) call. 

To receive a high priority nondata message, a task issues a 
GNDx call. 
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Sending Interrupt Messages 

A task can send interrupt messages to another task. Usually 
an interrupt message informs the receiving task of some unusual 
event in the sending task. An XMIx call can be up to 16 bytes 
long. In the interrupt call, specify the LUN assigned in the 
connect or accept call. Also specify the location and length of 
the message buffer. 

An interrupt call completes when the receiving node 
acknowledges to the sending node that it has received the message. 
The receiving node software places the interrupt message on the 
receiving task's network data queue. The receiving task must 
issue a get network data call to remove the message from the queue 
and place it in the task's message buffer. 

A task can have only one interrupt message outstanding on a 
logical link. Until the call completes, any subsequent attempt to 
send another interrupt message on that same link is returned with 
a specific error code in the I/O status word. 
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Terminating Activity on a Logical Link 

Any task can terminate activity on a logical link at any time. 
To do so, you can issue a disconnect call or an abort call. A 
DSCx call terminates transmissions and interrupts have been sent. 
An ABTx call disconnects the logical link immediately, regardless 
of any message queued for transmission. The receiving node 
software places the termination message on the receiving task's 
network data queue. The receiving task must issue a GNDx call to 
retrieve the message. 

In both disconnect and abort calls, you can specify the 
location and length of a user data buffer message for the 
receiving task. The message can be up to 16 bytes long. 

In the disconnect, call, specify the LUN assigned in the 
connect or accept call. When a disconnect call is issued, the 
software causes all pending transmits for the task issuing the 
disconnect call to complete before disconnecting the logical link; 
during this time, the task issuing the disconnect call continues 
to receive messages. When the last message is transmitted, any 
remaining receive calls are completed with an abort condition. 
When the link is disconnected, the LUN is released. A task can 
use that LUN in subsequent connect or accept calls. 

In the abort call, specify the LUN assigned in the connect or 
accept call. When an abort call is issued, the software 
immediately aborts all pending transmits and receives and 
disconnects the link. The LUN is released and a task can use that 
LUN in subsequent connect or accept calls. 
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Closing a Network Connection 

To close a task's network connection, issue a Close (CLSx) 
call. Ihe close call informs the software that the task no longer 
requires network services. This causes the software to purge the 
task's network data queue. Any active LUNs are deactivated and 
released for use if the task subsequently issues an Open (OPNx) 
call. 

If there is data in the task's network data queue when the 
close call is issued the following can occur: 

• If the terminating task's network data queue contains any 
connect requests, the terminating task receives them if it 
subsequently issues an open call within a short period of 
time. 

• Any other type of data in the terminating task's network 
data queue is discarded (for example, interrupt, 
disconnect, and abort messages). 
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Table 8 Task-to-Task Message Flow 



Local Node Remote Node 



User Task ECL ECL User Task 



CON$ > 



DSC$ > 



CI > 

< CI ACK 

< ACC$ 

< Connect Confirm 

^ REC $ 

< LS-Data Request 

LS-ACK > 

Data -> 

< : Da f.a AC K 



DSC -Re que st > 

< DSC -Confirm 
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Table 9 Network Call Summary for Task-to-Task 

Communication 

DECnet Calls for DECnet Calls for 

Logical Link (LL) Virtual Circuit (VC) Description 



MACRO-11 FORTRAN MACRO-11 FORTRAN 77 
77, COBOL, 
BASIC- 
PLUS-2 



Accessing/Deaccessing the Network's Facilities 

OPN$ OPNNT OPX$ OPXNW Declare a network task 

and open the task's 
mailbox 

CLS$ CLSNT CLX$ CLXNW End a task's network 

activity and close the 
task's mailbox 



Controlling a Logical Link/Virtual Circuit 



CON$ 
DSC$ 

ACC$ 
REJ$ 



ABT$ 



CONNT 



DSCNT 



ACCNT 



REJNT 



ABTNT 



CAL$ 
CLR$ 

CAC$ 

CRJ$ 

CTR$ 



CALNW 



CLRNW 



CACNW 



CRJNW 



CTRNW 



RES$ 



RESNW 



Connect request for LL; 
set up request for SVC 

Disconnect request for 
LL; clear request for 
SVC 

Accept the connect request 
for the LL; set up the 
request for the SVC 

Reject the connect request 
for LL; set up the request 
for SVC 

Transfer a set up request 
for SVC sent by a remote 
to another task 

Abort request for existing 
LL 

Reset VC ; confirm receipt 
of a reset 
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Table 9 Network Call Summary for Task-to-Task 
Communication (Cont) 

DECnet Calls for DECnet Calls for 

Logical Link (LL) Virtual Circuit (VC) Description 



MACRO-11 FORTRAN MACRO-11 FORTRAN 77 I 

77, COBOL, J, 

BASIC- % 

PLUS-2 » 



-ling. HP fc^^* ^« 



Accessing a Logical Link/Virtual Circuit ftfom/into a Task 



CONB$$ BACC, 
BFMT0, 
BFMT1 



NIBB$$, 
NIBF$$ 



APV$ 
DPV$ 



APVNW 
DPVNW 



'Building a connect 
block, access control 
block, destination 
descriptor, network 
information block 

Access a PVC 

Deaccess a PVC 



Sending and Receiving Data on Logical Link/Virtual Circuit 



SND$ 


SNDNT 


XMT$ 


XMTNW 


Transmit data 


REC$ 


RECNT 


RCV$ 


RCVNW 


Receive data 


XMI$ 


XMINT 


INT$ 


INTNW 


Transmit an 
interrupt data 






ICF$ 


ICFNW 


Interrupt receipt 
confirm 



Handling Unsolicited Data for Logical Link/Virtual Circuit 
GND$ GNDNT GNX$ GNXNW Get unsolicited data 



SPA$ 



WAIT NT 



SPX$ 



WAITNW 



Specify an AST 
routine for handling 
unsolicited data 

Suspend the task 
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Table 9 Network Call Summary for Task-to-Task 
Communication (Cont) 



DECnet Calls for 
Logical Link (LL) 

MACRO-11 FORTRAN 77, 
COBOL, 
BASIC -PL US -2 



DECnet Calls for 
Virtual Circuit (VC) 

MACRO-11 FORTRAN 77 



Description 



Miscellaneous 

GLN$ GLNNT 



TDN$ 



TDNNW 



Get local node 
information 

Translate DTE name 



Legend 

LL - Logical Link 
VC - Virtual Circuit 
SVC - Switched VC 
PVC - Permanent VC 
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Notes on MACRO-1 1 Programming 

1. Macro types: 

• Build-type macros - OPN[W]$ 

9 Execute— t v/ pe macros — OPN[W]$E 

• Stack-type macros - OPN[W]$S 

LABEL: XXX$ LUN, EFN, STAT, AST, <pl,p2, pn> 

;Create a parameter block 

;for the call designated 

;by XXX$ using a BUILD- 

;type macro. 
XXX[W]$E LABEL 

;Issue an EXECUTE-type macro 

/referencing the parameter 

;block created for LABEL. 
XXX[W]$S LABEL, ,,,,,<pl,p2> 

; Issue an EXECUTE-type macro 

;and override the parameter 

;list arguments Pi and P2. 
XXX[W]$S #LUN, #EFN,#STAT, #AST<#pl,p2> 

; Issue a STACK-type macro, create 

;a parameter block on the stack 

;and execute the call. 

Example 24 Macro Types for Programming 



2. Event flags 17-22 are used by FORTRAN 77, COBOL, and 
BASIC-PLUS-2 DECnet calls. Do not assign these event flag 
numbers to your MACRO-11 calls if you are using high-level 
language calls in the same program. 
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3. When using the wait option [W] in MACRO-11 calls, you must 
assign an event flag. If the flag is not specified, the 
call completes as a normal asynchronous call. 

4. Task must be assembled with NETLIB.MLB and/or PSI.MLB: 
MAO TASKA,TASKA/-SP=[1, 1 ]NETLIB/LB, [300, 300]TASKA 



5. See the examples in Section 2.3.16 of the 

DECnet-RSX Programmer's Reference Manual for additional 
information. 
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Notes on FORTRAN 77, COBOL, and BASIC-PLUS-2 Programming 

1. Event flags 17-22 are reserved and must not be used for 
calls. 

2. Task must be built with NETFOR.OLB, for example: 
TKB> TASKB,TASKB=TASKB, [1, 1]NETF0R/LB, [1, i]F0R0TS/LB 



3. COBOL and BASIC-PLUS-2 use NETFOR.OLB, so to issue calls 
do as follows: 

FORTRAN 77 - CALL OPNNT [W] (PI, P2, P3, . . . ) 

COBOL - CALL " OPNNT [W] n USING P1,P2,P3,... 

BASIC-PLUS-2 - CALL OPNNT [W] BY REF (PI, P2, P3 f . . . ) 

where P1,P2,P3, ... are the call's parameters. 

4. COBOL and BASIC-PLUS-2 tasks must be built as follows: 

TKB> TASKC,TASKC=TASKC, [1 , 1 jNETFOR/LB, [1, l]COBLIB/LB 
TKB> TASKD,TASKD=TASKD, [1, 1]NETF0R/LB, [1, 1]BASIC2/LB 

5. See the examples in Sections 3*7,18 through 3.7.23 of the 
DECnet-RSX Programmer's Reference Manual for additional 
information. 



55 



DECnet-RSX USER INTERFACE 



Remote File Access 



Table 10 Network Call Summary for Remote File Access 

DECnet calls for 

Logical Link (LL) Description 

FORTRAN 77, 

COBOL, 

BASIC -PLUS-2 



ACONFW 
ATTNFW 
OFWNFW 
OPANFW 
OPM NFW 
OPRNFW 
OPUNFW 
GETNFW 
PUTNFW 
CLSNFW 
DELNFW 
EXE NFW 
PRGNFW 
SPLNFW 
SUB NFW 



To set record and file access options 

To set extended attributes 

Create a sequential file 

Open a file for appending records 

Open and modify a sequential file 

Open a file for reading 

Open and update a sequential file 

Read a single record 

Write a single record 

Close a file 

Delete a file 

Execute a command file 

Discard an open file 

Spool the file 

Submit a command file for execution 



NOTE 
Destination task for Remote File Access is 
FAL (Object 17). 
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Notes on Remote File Access Programming 

These calls are implemented by subroutines. The network open 
call, OPNNTfW], and the network close call, CLWNT [W] . are also 
used in remote file access operations. You must always issue 
OPNNT [W] first because this routine allows your task to access the 
network. Issue CLSNT [W] last to close your task's access to the 
network. 

Each open subroutine creates a DECnet logical link to the node 

where the file resides and then creates and opens the file. You 

must use the same LUN to open, write, and close the file. This 
LUN must be one not in use. 

The maximum data record limit is 256 bytes. To override this 
default adjust the global symbol $NFRSZ to a higher number. 

1. All file access calls are synchronous. Therefore they do 
not return to the user until the operation completes. 

2. The following default parameters can be changed at 
taskbuild time: 

Event Flags: GBLDEF=. TREF : value (default is 17.) 

GBLDEF=.RCEF:value (default is IS.) 

Buffering Level: GBLDEF=$NFNMB:buf f er ing level 

(default is 2.) 

Maximum Record Size: GBLDEF=$NFRSZ : record size 

^(default is 256. bytes) 

Buffer Space Allocation: 

EXTSCT=$$FSRl:value (no default) 

3. Task must be built with NETFOR.OLB, for example: 
TKB> TASKE,TASKE=TASKE, [1, 1]NETF0R/LB, [1, l]FOROTS/LB 

4. See the examples in Sections 3.8.19 through 3.8.24 of the 
DECnet-RSX Programmer's Reference Manual for additional 
information. 
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Remote Task Control 

Table 11 Network Call Summary for Remote Task Control 

DECnet Calls for 

Logical Link (LL) Description 



FORTRAN 77 



RUNNCW Execute an installed task 

ABONCW Abort an executed task of cancel a 

scheduled task 

BACUSR Build access control information block 



NOTE 
Destination task for Remote Task Control is 
TCL (Obje ct 15) ._ 

Notes on Remote Task Control Programming 

1. All calls are synchronous and pass control back to the 
user task only after the operation completes. 

2. Task must be built with NETFOR.OLB, for example: 
TKB> TASKF, TASKF=TASKF, [1, 1]NETF0R/LB, [1, 1]F0R0TS/LB 

3. See the examples in Section 3.9.6 of the DECnet-RSX 
Programmer's Reference Manual for additional information. 
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Direct Line Access 

To use DLX, you issue queued I/O (QIO) calls to the NX: 
device. The DLX interface can be used to communicate over all 
devices supported by DECnet-RSX. 

You can use DLX QIO$ to communicate between your program and a 
program on an adjacent node using the DECnet-RSX or non-DECnet 
based system that has similar capabilities. In task-to-task 
communication between adjacent nodes, DLX significantly improves 
network performance in terms of CPU and line usage. You can build 
your own user level protocol that best suits the application. 



Table 12 Network Call Summary for Direct Line Access 

Direct Line Access Description 

(DLX) Calls Non-Ethernet Ethernet 



MACRO-11 



IO.X0P 

IO.XSC 
IO.XIN 
IO.XTM 
IO.XRC 
IO.XHG 
IO.XCL 



Open a line 



Not applicable 



Open an Ethernet 
device 



Initialize the line Not applicable 

Transmit a message Transmit a message 

Receive a message Receive a message 

Hang up a line Not applicable 

Close the line Not applicable 
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Notes on Direct Line Access Programming 

1. Special considerations for Ethernet users: 

• All messages on the Ethernet must include a 
destination address (48-bit) and a protocol type 
(16-bit). 

• Ethernet may be opened in three different modes 
(defined in EPMDF$ in NETLIB.MLB) : 

Exclusive 
- Default 
Normal 

• Ethernet users should refer to Section 4.2 in the 
DECnet-RSX Programmer's Reference Manual for addi- 
tional information. 

2. All tasks must be assembled with NETLIB.MLB, for example: 
MAO TASKG,TASKG/-SP=[1, 1]NETLIB/ML, [300, 311]TASKG 

3. See the examples in Section 4.3.9 through 4.3.10 of the 
DECnet-RSX Programmer's Reference Manual for additional 
information. 
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num: 

prmpt: 

iostn: 

buff: 

iostb: 

cnt: 

errcnt: 

iosb: 



conbl: 



start: 



dki: 



loop: 






i 



. I i I Lfc StNlU 

t*****x*ttt***tt***tt**t*t**********t*t***t**t****x*ttx*t***t* 

THIS EXAMPLE WILL : 

SEND 10 DATA MESSAGES UITH THE FORMAT 'THIS IS MESSAGE N' 
ACCEPT A SHORT MESSAGE FROM THE INITIATING TERMINAL 
AND SEND THIS MESSAGE OUT AS AN 'INTERRUPT MESSAGE'. 

t*X*XtXX*XtXttXt*t**ttXXXX^**XtX**t***tXtXttXt*XtXttXt*X*t**X* 
.MCALL OPNU$SfCONW$SfSNDWSSfCONB**fALUN*CfQIOU*C 
.MCALL EXIT*S»MRKT$CfUTS£$CfCLEF*C»SETF*C»QIO$C 
.MCALL DSCU«SrXMIU$S;ASTX*S 



~~ 



DATA AREA 



CODE 



mesn: 

.ASCI 
NN=.- 
.ASCI 
.EVEN 
.BLKU 
.BLKB 
.BLKU 
.WORD 
.UORD 
.BLKU 

.EVEN 
CONBSS 



.EVEN 

CLR 

CLEF$C 



MOVB 

ALUN*C 

ALUN«C 

OPNU*S 

TSTB 

BGT 

JMP 

CONUSS 

TSTB 

BLE 

QIO$C 



TST 

BLT 

MOV 

SNDU*S 

TSTB 

BLE 

INCB 

SOB 

WTS£*C 



.ASCII 
I /O/ 
MESN 

I /msg:/ 



/THIS IS MESSAGE / 



» MESSAGE TO BE TRANSMITTED 



2 

16. 

2 





1 



ELR0ND»0.1i<REC10> 



ERRCNT 
5 



V.'- 



» MESSAGE NUMBER 

i PROMPT FOR INTERRUPT MESSAGE 

J COMPLETION STATUS FOR NETWORK 

i INTERRUPT MESSAGE BUFFER 

J COMPLETION STATUS FOR BUFFER 

} NUM OF CHAR IN INTERRUPT MESS 

» ERROR COUNT 

i I/O STATUS 



CONNECT REQUEST BLOCK 



INITIALIZE ERROR COUNT TO ZERO 
CLEAR EVENT FLAG USED TO MAKE SURE 
INTERRUPT MESSAGE ACCEPTED PRIOR 
TO EXIT 

INITIALIZE MESSAGE NUM TO ZERO 
ASSIGN LUN 1 FOR NETWORK DATA QUEUE 
ASSIGN LUN 2 FOR LOGICAL LINK 
CREATE THE NETWORK DATA QUEUE 
TEST FOR ERRORS 



only i 

** A*' 

fir \% r*>X 



*60fNUM 

1fNS"\ 

2fNS 

#lf#r»#IOSTN 

IOSTN 

OKI 

ERR1 

#2»*2»#I0STNff<#C0NBL> 

IOSTN 

ERR 2 

I0.RPRf5f»fI0STB»TRMASTf<BUFFf16. f fPRMPTf4> i ACCEPT 

f INTERRUPT MESSAGE FROM TERMINAL 
f (USE AST)C16 CHAR MAX3 
i TEST FOR ERRORS 



CREATE LOGICAL LINK TO 
TEST FOR ERRORS 



'REC10' 



*BSU 

ERR3 

♦IO.fRO 

#2»*2»*I0STNr 

IOSTN 

ERR4 

NUM 

ROjLOOP 



DSCWSS #2f#2f#I0STN 



', SET LOOP COUNTER TO 10 
:*MESN»*NN> , SEND MESSAGE 

» TEST FOR ERRORS 

i UPDATE MESSAGE NUMBER 

i LOOP IF MORE TO SEND 

i MAKE SURE TERMINAL MESSAGE 

f HAS BEEN ENTERED 

f BEFORE EXITING 

} DISCONNECT NETWORK 



Example 25 Task-to-Task Communication (Sheet 1 of 5) 



61 






DECnet-RSX USER INTERFACE 



EXIT$S 
TERMINAL AST ROUTINE 



i EXIT 



trmast: 



MOV 
MOV 
XMIU$S 



TSTB 

BLE 

SETF*C 

ASTX$S 



(SP>+,IOSB i POP STACK 

IOSTB+2,CNT i OBTAIN NUMBER OF CHARACTERS 

#2,#3,#IOSTN, ,<#BUFF,CNT>J TRANSMIT INTERRUPT MESSAGE 

J (NOTE USE OF EF 3 INSTEAD OF 
! EF 2 - AVOID COMPETITION) 
; TEST FOR ERRORS 



IOSTN 
ERRS 



SET EVENT FLAGE TO INDICATE 
INTERRUPT MESSAGE SENT 
AST EXIT 



ERROR HANDLING - A SAMPLE DEBUGGING TECHNIQUE 



errs: 

ERR4: 
ERR3: 
ERR2! 

erri: 



INC 
INC 
INC 
INC 
INC 
MOV 
MOV 
MOV 
MOV 
IOT 



ERRCNT 

ERRCNT 

ERRCNT 

ERRCNT 

ERRCNT 

ERRCNT, Rl 

$BSU,R2 

IOSTN, R3 

I0STN+2,R4 



DETERMINE 
WHICH 
ERROR 
OCCURRED 

Rl CONTAINS THE ERROR NUMBER 
R2 CONTAINS THE DIRECTIVE STATUS UORE 
R3 CONTAINS THE FIRST I/O STATUS WORD 
R4 CONTAINS THE 2ND I/O STATUS WORD 
ABORT - DUMP THE REGISTERS 



.END START 

Example 25 Task-to-Task Communication (Sheet 2 of 5) 
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.TITLE R£C10 

THIS EXAMPLE WILL: 

ACCEPT SHORT MESSAGES FROM THE SENDER TASK 8 SND10 S 
PRINT THE MESSAGES ON THE CONSOLE DEVICE (CO J) 
DISCONNECT AND EXIT GRACEFULLY. 

t**t*t*t*t*ttx**titttttttttt*****t*tttt*t**t****tt*t*t***t*** 

,MCALL OPNW*S»SPAW$SfRECW*S*GNDW$S?ACCU$SfCLSW$S?NETBF$ 
.MCALL QIOU$S»ALUN*C»CLEF»CFUTSE$C»SETF$CfASTX$S»EXIT*S 
NETBF* 



DATA AREA 



bufi: 

BUF2! 
IOST: 
IOSTlt 
I0ST2: 

iosb: 
errcnt; 

CNTI 

cntb: 
flag: 



.BLKB 

.even 

.BLKB 
.BLKW 
.BLKU 
.BLKW 
.BLKW 
.WORD 
.WORD 
.BLKB 
.WORD 
.EVEN 



N.CBL 
2 



i BUFFER FOR USER MESSAGES 

BUFFER FOR NETWORK MESSAGES 
COMPLETION STATUS FOR NETWORK 
COMP. STAT. FOR GET NET DATA 
COMP. STAT. FOR ACCEPT CONNECT 
I/O STATUS 
ERROR COUNT 

USER MESSAGE CHAR COUNT 
INTERRUPT MESSAGE CHAR COUNT 
DISCONNECT FLAG 



* CODE 
i 

start: 



loop: 



clr 

CLEFSC 

ALUNSC 

ALUNSC 

QPNWSS 

TSTB 

BLE 

SPAWSS 

TSTB 

BLE 

WTSE*C 

RECWSS 

TSTB 

BLE 

MOV 

QIOU«S 

TST 

BEQ 

CLSU$S 

TSTB 

BLE 

EXIT$S 

BR 



ERRCNT 
10. 

lrNS 

2»NS 

*1,-#1H 

IOST 

ERR1 

♦l»*li 

TOST 

ERR2 

10. 

*2>*2r 
IOST 
ERR3 
IOST+2 
#10. WL 



FLAG 
LOOP 
*1.*1»*I0ST2 

I j o I 2 
ERRS 

Loop 



» INITIALIZE ERROR COUNT TO ZERO 

i CLEAR EVENT FLAG USED TO MAKE 

i SURE CONNECT HAS OCCURRED 

i ASSIGN LUN 1 FOR NETWORK DATA QUEUE 

t ASSIGN LUN 2 FOR LOGICAL LINK 

#IOST 5 CREATE THE NETWORK DATA QUEUE (-w^<«-i 

} TEST FOR ERRORS 

*IOST»#CMPAST»<*NETAST> t SPECIFY AST HANDLING 

• TEST FOR ERRORS 

f WAIT TO MAKE SURE CONNECT 

i HAS OCCURRED 
♦IOSTf f<#BUFl»*25.>» RECEIVE UP TO 25 CHARS 

t TEST FOR ERRORS 

fCNT } OBTAIN CHARACTER COUNT 

B»*5f#5» »»r<#BUFl,CNT»#40>f TYPE MESSAGE 

i ON TERMINAL 

i HAS DISCONNECT OCCURRED? 

J N0» POST ANOTHER RECEIVE 

- r CLOSE NETWORK 

t TEST FOR ERRGko 



i PROGRAM EXIT 
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i ERROR HANDLING - A SAM 


ERR6: 


INC 


ERRCNT 


errs: 


INC 


ERRCNT 


ERR 4: 


INC 


ERRCNT 


ERR3*. 


INC 


ERRCNT 


ERR2J 


INC 


ERRCNT 


erri: 


INC 


ERRCNT 




MOV 


ERRCNT»R1 




MOV 


*DSUrR2 




MOV 


I0ST,R3 




MOV 


I0ST+2fR4 




IOT 





Rl * ERROR NUMBER 

R2 = DIRECTIVE STATUS WORD 

R3 = I/O STATUS BLOCK (1ST WORD) 

R4 = I/O STATUS BLOCK (2ND WORD) 

ABORT - DUMP REGISTERS 



AST HANDLING FOR DATA IN NETWORK DATA QUEUE 



cmpast: 


MOV 


(SP)+»I0S8 




MOV 


RO»-(SP) 




MOV 


IOSBrRO 




CMPB 


*IS.SUC»(RO) 




BEQ 


OKA 




JMP 


OUT 


oka: 


MOV 


2(R0)»R0 




BNE 


OKB 




JMP 


OUT 


okb: 


BR 


GET 


netast: 


MOV 


ROr-(SP) 




MOV 


#l»RO 


get: 


GNDW*S 


♦l»#lr#I0STlr»<*BUF2t*N 




BCS 


OUT 




CMPB 


♦IS.SUCf IOST1 . 




BNE 


OUT 




CMPB 


#NT.CON»IOSTl+l 




BNE 


OTHER 




ACCW$S 


*2»*2»#I0ST2f »<*BUF2> 




TSTB 


I0ST2 




BLE 


ERR4 




SETF*C 


10. 




BR 


NEXT 


other: 


CMPB 


*NT.DSC»I0ST1+1 




BNE 


0THR2 




MOV 


*1»FLAG 


i 


BR 


NEXT 


i 

0THR2: 


CMPB 


♦NT.INT.I0ST1+1 




BEQ 


OKC 




JHP 


ERRA 


o".c: 


rov3 


IC2Tn2»CI!TB 




QIOW$S 


*I0.WLP»#5»*3r r » »<*P 



i SAVE SPA* I/O STATUS BLOCK ADDR 

i SAVE RO 

J GET I/O STATUS BLOCK ADDRESS 

t SUCCESSFUL? 



» GET CURRENT NETWORK DATA COUNT 



5 SAVE RO 

i SET NETWORK DATA COUNT TO 1 
,CBL> i GET NETWORK DATA 

i CARRY BIT SET - ERROR 

I SUCCESSFUL? 

t CHECK IF CONNECT REQUEST 

f ACCEPT CONNECTION 

t TEST FOR ERRORS 

t SET EVENT FLAG TO INDICATE 

f CONNECT HAS OCCURRED 

t CHECK IF DISCONNECT REQUEST 

i SET DISCONNECT FLAG 

; GO BACK TO MAIN ROUTINE 



i CHECK IF INTERRUPT MESSAGE 
i NOT A EXPECTED COMMAND 

; obtain ch»'.?a:tzr c^u.-.r 

»<*PUF2»CNTBi*40> f TYPE INTERRUPT MF'G..': 
f (NOTE USE OF E r 3 
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next: nop 

DEC RO 

BEQ OUT 

JhP GET 

OUT: HOY <SP)+»RO 
A3TXSS 



•END START 



f INbltAii Uh ti- Z>> 
i CHECK IF MORE DATA 



i RESTORE RO 
i AST EXIT 
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INTEGER*2 MLTYPr RECSIZrSNBSIZr OPNLUN»CONLUN»MESNUM» XMITS » NDLENr TSKLEN 

INTEGER*2 I0ST<2> t MSTATC3) 

BYTE ERRMES<2)»TSKNAH<6>»C0NBLK<72>»NDNAH(6>>BEFN0D<6>»BEFTSK<6) 

BYTE SNDBUF(50)fRECBUF<10) 

L0GICAL*1 STATflMHED 

DATA DEFNOD/'M'f'A'f 'S'f 'T'»'E'f 'RV 

DATA DEFTSK/'R'»'E't'C'»'V'»'E'»'R'/ 



INITIALIZE CONSTANTS 

IMMED=.TRUE. 

0PNLUN=1 

C0NLUN*2 

XMITS=20 

SNDSIZ=50 

RECSIZ=10 



!* SET IMMED TO TRUE FOR GNDNTW 

!* NETWORK OPNNT- LUN 

!* COUNT LUN FOR THE 

!* LOGICAL LINK 

!* THE NUMBER OF INQUIRIES 

!* TO BE SENT TO THE REMOTE NODE 

!* THE SIZE OF THE THE MESSAGES TO 

!* BE SENT TO THE REMOTE NODE 

!* THE SIZE OF THE MESSAGES TO 

!* BE RECEIVED 



GET THE NODE AND TASK NAMES 



TYPE 300 
READ(5»310) 



!* ASK FOR NODE-NAME 
CNDNAM(NDLEN),NDLEN=1»6) !* GET THE NAME 



DO 5 NDLEN=6»1»-1 

IF (NDNAM(NDLEN).NE. 

CONTINUE 

DO SO 1=1*6 

NDNAM(I)=DEFNOD(I) 

NDLEN=6 



) GOTO 6 



!* LOOP TO FIND LENGTH OF NAME 
!* IF NOT A SPACEf GET TASK-NAME 



!t DEFAULT NODE NAME 'MASTER' 
!* LENGTH OF DEFAULT NAME 



7 
60 



TYPE 320 •* ASK FOR THE TASK-NAME 

READ(5f310> (TSKNAM(TSKLEN)»TSKLEN=1»6> !* GET IT 

DO 7 TSKLEN«6»lf-l !* TSKLEN IS LENGH OF TASK-NAME 

IF (TSKNAM(TSKLEN).NE.' ') GOTO 8 !* IF NOT SPACEf ACCESS NETWORK 

CONTINUE 

DO 60 I=l»6 

TSKNAM(I)=DEFTSK(I) 

TSKLEN=6 



!* DEFAULT TASK NAME 'RECVER' 
!* LENGTH OF DEFAULT NAME 



C 
C 
C 
10 



ACCESS NETWORK 



CALL 
IF 



OPNNTW(OPNLUN»IOST f MSTAT) 

(lOST(l).NE.DGOTO 100 !* IF FAILURE JUST EXIT 



BUILD A FORMAT 2 CONNECT BLOCK 

CALL BFMT1(STAT»C0NBLK»NDLEN»NDNAHj >*fSKLEN»TSKNAM) 

IF (STAT)GOTO 10 !* IF SUCCESS GO ON 

TYPE 200 !* ELSE TYPE OUT A FAILURE 

!* NOTIFICATION 
GOTO 90 !* AND EXIT 

CONNECT TO THE TASK ON THE REMOTE NODE 

CALL CONNTW(CONLUN»IOST»CONBLK) 

IF (IOST(D.EQ.l)GOTO 15 !* IF SUCCESS TELL HIM 

TYPE 240»I0ST !* ELSE PRINT STATUS BLOCK 

GOTO 90 !* DEACCESS THE NETWORK 
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c 
c 
c 

20 



TYPE 



220 



!* AND EXIT 

!* PRINT CONNECT CONFIRMATION 

!t NETWORK AND EXIT 



SEND AND RECEIVE MESSAGES TO AND FROM THE REMOTE NODE 

DO 40 MESNUM=1»XMITS 

FIRST GET ANY ERROR MESSAGES SENT FROM THE OTHER SIDE MIA 
INTERUPT MESSAGES 

IF (MSTAT(D.EQ.O)GOTO 20 !* IF MSTAT(1)=0 NO MESSAGES 

!* ARE THERE 

CALL GNDNTW<I0ST»MLTYP,2rERRMES»> IMMED,2) !* GET THE MESSAGE 

* IF WE COULDN'T GET THE MESSAGE 

* JUST IGNORE IT 



IF (IOST(l) .NE.DGOTO 20 
TYPE 210>ERRMES(1) 
SEND THE INQUIRY 



* PRINT OUT THE MESSAGE 



CALL SNDNTW(CONLUN»IOST,SNDSIZfSNDBUF) 

IF <I0ST<1).£Q.1)G0T0 30 «* IF SUCCESS CONTINUE 

TYPE 210fMESNUM !* OTHERWISE TYPE OUT AN 

!* ERROR MESSAGE 
GOTO 40 !* AND START A NEW MESSAGE 



C RECEIVE THE RESPONSE FROM THE REMOTE NODE 

C 

30 CALL RECNTW(CONLUN»IOST»RECSIZ»RECBUF) 



40 
C 

C 

c 



IF 
TYPE 



<I0ST<1) .EQ.DGOTO 40 
210*MESNUM 



CONTINUE 
DISCONNECT THE LINK 



TYPE 
CALL 



230 
DSCNTW(CONLUN»IOST) 



!*IF SUCCESS CONTINUE 

!* OTHERWISE TYPE OUT AN 

!* ERROR MESSAGE 



!* PRINT OUT DISCONNECT MESSAGE 



C 

C 

C 

90 CALL 

100 STOP 

C 

C FORMAT STATEMENTS 



COME HERE TO DEACCESS THE NETWORK AND EXIT 



LL5«I W 

'END OF PROGRAM EXECUTION' 



200 FORMAT 

210 FORMAT 

220 FORMAT 

230 FORMAT 

240 FORMAT 

300 FORMAT 

310 FORMAT 

320 FORMAT 
END 

INTEGER*2 OPNLUNr HLTYPf INDEX »ACCLUN» NUMBER t NUMhES 
INTEGER*2 RECSIZ»SNDSIZ» INTSIZ 
INTEGER*2 MSTAT(3) t I0STC2) t I0ST1 ( 2) f I0ST2(2) 
BYTE RECBUF(50)fSNDDAT(10) jMLBX(98)»INTMES(2) 



' ERROR BUILDING CONNECT BLOCK') 

' ERROR ON INQUIRY ',13) 

' LINK ENABLED') 

' LINK DISABLED') 

' CONNECT FAIL: IOST= '»I3) 

' PLEASE ENTER NODE-NAME <MASTER>: 

5A1) 

' PLEASE ENTER TASK-NAME <RECVER>: 



'»*) 



'»$) 



INITIALIZE CONSTANTS 

0PNLUN=1 

ACCLUN=2 

RECSIZ=50 

INTSIZ=2 

NUMMES=0 



!* NETWORK OPNNT LUN 

!* ACCNT LUN FOR THE LOGICAL LINK 

!* SIZE OF DATA BUFFER TO BE RECEIVED 

!* SIZE OF INTERRUPT DATA BUFFER TO SEND 

!* NUMBER OF MESSAGES RECEIVED 
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SNDSIZ=10 !* NUMBER OF BYTES TO SEND BACK 

C 

C ACCESS NETWORK 
C 

CALL OPNNTW(OPNLUN,IOSTrMSTAT> 

IF (IQST(l).NE.l)GOTO 100 !* IF FAILURE JUST EXIT 

IF (HSTAT<1).EQ.0)G0TQ 40 !* IF NOTHING ON MAILBOX 

!* JUST CLOSE AND EXIT 
10 CALL GNDNT(I0STlrMLTYPf98fMLBX) !* ISSUE A GET NETWORK DATA 
20 CALL WAITNT<INBEX»IQST1»I0ST2> !* WAIT FOR A COMPLETION 

IF (INDEX. EQ.2)G0T0 50 !* IF INDEX-2 A RECEIVE HAS 

!* BEEN COMPLETED 
C 

C NETWORK DATA HAS BEEN RECEIVED 
C 

IF (IOSTKD.NE.DGOTO 40 !* IF GNDNT FAILED JUST 

!* CLOSE AND EXIT 

IF (MLTYP,GE.3)G0T0 40 !* IF MULTYP>=3 THE LINK HAS 

!* BEEN BROKEN 

IF (MLTYP.EQ.2)G0T0 10 !* IF MLTYP=2 WE'VE RECEIVED 

!* AN INTERRUPT MESSAGE* JUST 
!* ISSUE A NEW GNDNT 
C 

C WE'VE RECEIVED A CONNECT REQUEST - ISSUE AN ACCEPT 
C 

CALL ACCNTWCACCLUNt IOSTrMLBX) 

IF <IOST<1).NE.1>GOTO 10 !* IF FAILURE ISSUE A NEW 

!* GNDNT 
C 

C ISSUE A RECEIVE TO PICK UP DATA 
C 
30 CALL RECNT(ACCLUN,I0ST2»RECSI2iRECBUF) 

GOTO 10 !* ISSUE A NEW GNDNT 

!* AND WAIT FOR A COMPLETION 
C 

C WE COME HERE UPON RECEIVING A DISCONNECT OR ABORT 
C 
40 CALL CLSNTW !* DEACCESS THE NETWORK 

GOTO 100 !* AND EXIT 

C 

C WE COME HERE IF WE RECEIVE AN INQUIRY 
C 

50 NUMMES=NUMMES+1 !* INCREMENT THE MESSAGE 

!* COUNT 

IF (I0ST2(1>.EQ.1)G0T0 60 !* IF I0ST2(1)-1 ALL'S O.K. 

C 

C IF THERE WAS AN ERROR SEND BACK AN INTERRUPT HESSAGE WITH 
C MESSAGE NUMBER 
C 

INTMES(1)»NUMMES !* SEND THE MESSAGE NUMBER 

CALL XMINT(ACCLUN» IOST, INTSIZ» INTMES) 

GOTO 70 !* GO ISSUE A NEW RECEIVE 

C 

C HERE THE USER CAN LOOK AT THE DATA RECEIVED IN RECBUF AND RESPOND 
C BY PLACING THE REQUESTED INFORMATION INTO SNDDAT 
C 
C 

C SEND BACK THE DATA AND ISSUE A NEW RECNT 
C 

60 CALL SNDNTW(ACCLUNiIOST»SNDSIZ»SNDDAT) 
70 CALL RECNT(ACCLUNf I0ST2f RECSIZrRECBUF) 

GOTO 20 !* WAIT FOR A COMPLETION 

C 

C EXIT PROGRAM 
C 
100 STOP 'END OF PROGRAM EXECUTION' !* HALT THE PROGRAM 
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c 

C THIS PROGRAM IS A VARIATION OF THE PROGRAM THAT APPEARS IN THE 

C RSX DECNET PROGRAMMER'S REFERENCE MANUAL 

C 

BYTE NODE ( 7 > » BUFFER ( 128 ) » IBENT < 30 ) t ICHAR ( 3 ) 

INTEGER ISTAT(2)»JSTAT(2)»KSTAT<2)rLSTAT(2)»MSTAT<3)>NSTAT(2) 

DATA ICHAR/'A'f 'V'» 'F'/ 
C 

C GET USER ID. PASSWORD AND ACCOUNT 
C 

TYPE 666 

666 FORMAT C*ENTER USER I.D.I ') 
ACCEPT 77? t ICNT t ( IDENT( I ) » 1*1 , ICNT) 
IDENTUCNT + 1>=0 

TYPE 667 

667 FORMAT CSENTER PASSWORD: ') 

ACCEPT 77?fICNT?f ( IDENT( I ) » I=ICNT+2» ICNT+2+ICNT9-1 ) 

IDENT(XCNT+2+ICNT9)=0 

TYPE 668 

668 FORM'tT CSENTER ACCOUNT NUMBER: ') 
K=ICNT+l+ICNT9+2 

ACCEPT 779»ICNT8»(IDENTCI),I=K.K+ICNT8-1) 
779 FORMAT (Q»10A1) 

TYPE tt 'IDENT = ' t ( IDENT( I ) , 1 = 1 » 15) 

TYPE *> <IDENT(I)»I=16»30) 
C 

C GET REMOTE NODE NAME LOCAL AND REMOTE FILE SPECS 
C 

95 • TYPE 100 
100 FORMAT <'$ENTER REMOTE NODE NAME <6 CHAR. MAX.):') 

ACCEPT 110f ICNT3»(N0DE(I)» I=lr ICNT3) 
110 FORMAT (Q.6A1) 

IF (ICNT3-6) 115.115.95 
115 TYPE *.'NODE NAME = ' . (NODE( : ) » 1=1 . 7) 

TYPE 120 
120 FORMAT C$ENTER FILE SPEC. OF REMOTE FILE FOR APPEND:') 

ACCEPT 130 » ICNT 1 » ( BUFFER ( I ) » 1 = 1 1 ICNT1 ) 
130 FORMAT (Q.64A1) 

BUFFER(ICNT1+1)=0 

TYPfc 140 
140 FORMAT ('VENTER FILE SPEC. OF LOCAL FILE TO BE APPENDED'.') 

ACCEPT 150. ICNT2.( BUFFER < I), 1=64. 63+ICNT2) 
150 FORMAT (Q.64A1) 

Bur r ER \ ICr»72To4)— 
C 

C CREATE NETWORK MAILBOX FOR ONLY ONE LINK 
C 

CALL OPNNTW (2.LSTAT.MSTAT, 1 ) 

IF (LSTAT(l)-l) 907.160.907 
C 

C OPEN LOCAL AND REMOTE FILES 
C 
160 OPEN <UNIT=4»NAME*BUFFER(64>»TYPE='0LD' »ERR=901) 

CALL OPANFW ( 1 , ISTAT.NODE. IDENT • BUFFER* TCHAR, LENGTH. IBLOCK) 

IF (ISTAT(l)-l) 908.200.908 
C 

C READ RECORDS FROM LOCAL FILE AND WRITE THEM TO REMOTE FILE 
C 

200 READ <4,210»END=300»ERR=902) ICNT3. (BUFFER( I ) » 1=1 . ICNT3) 
210 FORMAT (Q.128A1) 

CALL PUTNFW < 1 . JSTATi ICNT3.BUFFER) 

IF (JSTAT(l)-l) 903*200.903 
C 

C EOF FOUND — CLOSE BOTH FILES AND NET 
C 
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300 CLOSE (UNIT=4»ERR»904> 

CALL CLSNFW <1,KSTAT) 

IF (KSTAT(l)-l) 905»310»905 
310 CALL CLSNTU (NSTAT) 

IF (NSTAT(l)-l) 90<&»320»906 
320 STOP 'APPEND O.K.' 
C 

C ERROR HALTS 
C 

901 TYPE *» <BUFFER(I)»I»lf63) 
TYPE *» (BUFFER(I)f I=64»128) 
STOP 'CAN NOT OPEN LOCAL FILE' 

902 STOP 'READ ERROR FROM LOCAL FILE' 

903 TYPE *»'STATUS ='»JSTAT<1> 

STOP 'WRITE ERROR FROM REMOTE FILE' 

904 STOP 'CAN NOT CLOSE LOCAL FILE' 

905 TYPE *>'STATUS -'fKSTAT(I) 

STOP 'CAN NOT CLOSE REMOTE FILE' 

906 STOP 'CAN NOT CLOSE NETWORK' 

907 TYPE *t 'STATUS ='» LSTAT(l) 
STOP 'MAILBOX CREATION ERROR' 

908 TYPE *t'STATUS ■' t ISTAT< 1 ) t ISTAT<2> 
STOP 'CAN NOT OPEN REMOTE FILE' 

C 

END 
C read fro* 3 remote file and write to a remote file using 
C decnet fortran remote file access support 

C declare the necessary data structures 

DIMENSION IARRAY(256)rISTAT(2)f IBLK(1).LNTH(1) 

COMMON ISTAT 

LCGICAL*1 IDINF0(13)f ICHARSC3) 

LOGICAL EOF 

DATA EOF/. FALSE./ 

C ASCIZ strings for user IDr password and account number. 

DATA IDINFO/'J'»'0' r'E'f0»'P'»'R'.'I'»'V'»0f'4'»'0'F'4'»0/ 
C array containing mode* record type and carriage control information 

DATA ICHARS/'I'»'V'f 'T'/ 

c declare network, task 

CALL 0PNNTW<7rISTAT,,2> 
CALL CKSTAT 

C open two files* one for input and one for output. 
C both of these files exist on a remote node. 

C open file for input 

CALL OPRNF'JUflSTATf'IASNOD' »IDINF0»' 
C133f224 3NET.TST'fICHARS»LNTH»> 
CALL CKSTAT 

C open file for output 

CALL 0PUNFW<2fISTAT» ' I ASNOD ' r IDINFO. ' 
C133»224 3NEWNET.TST'»ICHARS»LNTHf > 
CALL CKSTAT 

C once the files are successfully opened* we may transfer records. 
C the file associated with lun 1 is opened for readina* the 

i 
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C file on lun 2 is opened for writina. 

C transfer files 
DO 30 X-lrlOOtl 

C set 3 record fro* the input file. 

CALL GETNFy<i»ISTATi256f IARRAY) 
C status code 050047 is end of file 

IF (ISTAT(l) .NE. 1 .AND. ISTAT<2) .NE. "050047) GO TO 40 
LNTH(l) ■ ISTAT(2> 

C check for end of file 

IF (ISTAT(l) .NE. 1 .AND. ISTATC2) .EG. "050047) E0F=.TRUE, 
IF (EOF .EQ. .TRUE.) GO TO 50 
CALL PUTNFU(2»ISTAT»LNTH» IARRAY) 

IF (ISTAT(l) .NE. 1 .AND. ISTAT(2) .NE. "050047) GO TO 40 
30 CONTINUE 

40 PRINT 41 

41 FORMAT UHlr'READ OR WRITE ERROR OCCURRED') 

C close files 

C *now that files have been transferred ue may close 

C the files 

50 DO 55 I=lr2»l 

CALL CLSNFU(I.ISTAT) 
55 CONTINUE 

IF (EOF .NE. .TRUE.) GO TO 60 
PRINT 57 
57 FORMATUHli'END OF FILE REACHED. FILES CLOSED') 

60 



10 



STOP 
END 










SUBROUTINE 

DIMENSION 

COMMON 


CKSTAT 

ISTAT(2) 

ISTAT 








IF (ISTATXl) .EQ.l) 

F0RMAT(1H1,'0PEN ERROR') 

PRINT 5 

STOP 

RETURN 

END 


GO 


TO 


10 
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c 

C RUNABO.FTN 

C 

C - USES THE I'ECNET TASK CONTROL CALLS TO RUN OR ABORT A 

C TASK ON THE SPECIFIED NODE (LOCAL OR REMOTE). 

C - TASK 'TCL' t.UST BE IflSTnLLED AT THE TARGET NODE.s 

C - SAMPLE COMMANDS TO DEVELOP THIS TASK FOLLOU 

C 

C >FOR RUNABOfRUNABO=RUNABO 

C >TKB RUNABOfRUNABO=RUNABOfC1f13NETF0R/LB 

C >INS RUNABO/TASK=...CTL 

C 

LOGICAL*l ANSWERfRUNfAB0fTARTSK(6>fTARN0D<6)fPASSWB<8)fUSERIDU6> 

LQGICAL*1 ACCNTU6) 

INTEGER STATUS(2)fSTAT 

INTEGER*2 MSTAT(3> 

DATA RUN/'R'/fABO/'A'/ 
C 
C CREATE NETWORK DATA QUEUE 

-"" '" "CALL OPNNTUdr STATUS rMSTAT) 

IF (STATUS(l) .NE. 1) WRITE( 5 f8)STATUS( 1 ) 
C 

C PROMPT FOR TARGET NODE» AND TARGET TASK. 
C 

10 URITE(5tl) 

1 F0RMATC5Xf*'TARGET NODE ? t') 
READ ( 5 f 2 r END=999 ) ICNT1 , TARNOD 

2 F0RMAT(Q»16A1) 
C 

URITE(5f3> 

3 F0RMAT(5X»*'TARGET TASK 11') 
READ<5f2fENB=999)ICNT2»TARTSK 

C ' 

C PROMPT FOR ACCESS CONTROL INFORMATION 

C 

URITE(5f50) 
50 F0RMAT(5Xf*'TARGET USER I.D. ?:') 

READ <5f2fEND=999)ICNT4fUSERID 
C 

WRITE(5i4) 
A FORMAT(SX»*'TARGET PASSWORD ?X"i 

READ <5f2fEND=99?)ICNT3fPASSWD 
C 

WRITE(5rll) 

11 F0RMAT(5Xf$'TARGET ACCOUNT NUMBER ?'.') 
READ C5f2fEND=999>ICNT5fACCNT 

C 

. WRITE(5i6) 

6 F0RMAT(5Xi$'RUN (R) OR ABORT (A) ? :') 
READ< 5 f7fEND=999> ANSWER 

7 FORMAT(Al) 
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c 

C DECIDE WHETHER TO CALL BACUSR 
C 

IF (ICNT4 .EQ, .AND, ICNT5 .EQ. 05 GO TO 70 
CALL BACUSR (STAT, ICNT4 >USERID, ICNT5, ACCNT) 
IF (STAT .EQ. .TRUE.) 60 TO 70 
WRITE(5»80)STAT 
80 FORMAT (' ERROR BUILDING CONNECT BLOCK ') 
GOTO 10 
C 

C DECIDE WHETHER TO RUN OR ABORT THE TASK. 
C 

70 IF (ANSWER .EG. ABO) GOTO 20 
IF (ANSWER .EQ. RUN) GOTO 30 
GOTO 99? 
C 

C ABORT THE TASK, AND PRINT STATUS. 
20 WRITE (5,100) 
100 FORMAT (5X»$'IF A PRIVILEGED PASSWORD IS USED, ENTER 0. IDENT ?:') 

READ (5,110)IDENT 
110 F0RMATU6) 

CALL ABONCW ( 2 'STATUS, ICNT1 ,TARNOD, ICNT3, PASSWD , ICNT2 , TARTSK, IDENT) 
C 

WRITE(5,8)STATUS(1) 
8 FORHATC STATUS = ',17) 
GOTO 10 
C 

C RUN THE TASK, AND PRINT STATUS. 
C 

30 CALL RUNNCW ( 2, ST ATUS, ICNT1,TARN0D> I CNT3, PASSWD, ICNT2, TARTSK, IDENT) 
WRITE (5,8)STATUS(1) 

IF (STATUS(l) .EQ. 1) WRITE (5,90) IDENT 
90 FORMAT (' THE IDENT IS ',16) 



GOTO 10 
999 STOP 
END 
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Shooldb€ 12 pt 
ERCiSES ;^ dift *£y/t& jfz€ /*W? &//*&&& 4&#4tf f 

Match the following DECnet utilities and RSX supported 
languages to the appropriate functions that they can 
perform/support. Each item may be used once, more than once, or 

Used to transfer files in 
a spooled environment. 

Used for terminal-to-terminal 
communication on the local 
node . 

Supports only task-to-task and 
DLX communication. 

Is the general purpose server 
task for remote file access. 

Allows remote terminal communi- 
cation between two DECnet-RSX 
nodes. 

Is the programming interface for 
all task-to-task communication. 

Can list remote directories 
immediately to the TI: device. 

Is the requester task for the 
LSN task. 

Will allow remote task control. 

Allows input from a command file. 



not at all. 






x < 


RMT 
FTS 




a. 


2. 






. NFT 




b. 


3. 




4, 


TLK 








FORTRAN-77 


c . 


5, 




6 


. MACRO- 
LSN 


•11 


d. 


7 






. COBOL 




e . 


8 




9 


. FAL 








. NS: 






10 










g- 




h. 








i • 




j- 



riQM"-K,ci*clp9. 



75 



DECnet-RSX USER INTERFACE 



Solutions' diPtyp* #z±? 



5hov)ld b« l*p£. 



Match the following DECnet utilities and RSX supported 

languages to the appropriate functions that they can 

perform/support. Each item may be used once, more than once, or 
not at all. 



1. 


RMT 


2. 


FTS 


3. 


NFT 


4. 


TLK 


5. 


FORTRAN-77 


6. 


MACRO-11 


7. 


LSN 


8. 


COBOL 


9. 


FAL 


10. 


NS: 



a. 2 Used to transfer files in 

*""""""* a spooled environment. 

D - 4 Used for terminal-to-terminal 

communication on the local 
node. 

c. 6 Supports only task-to-task and 
~" DLX communication. 

d. 9_ Is the general purpose server 
"~ ~ task for remote file access. 

e. 1 Allows remote terminal communi- 

cation between two DECnet-RSX 
nodes. 

f . 10 Is the programming interface for 
mmmmm all task-to-task communication. 

g. 3 Can list remote directories 

immediately to the TI: device. 

h. 4 Is the requester task for the 

~ LSN task. 



i. 5 Will allow remote task control, 

j. 2,3,4 Allows input from a command file. 



Ansuters are 

-h> l>e underlie*' 
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^B EXERCISES) M fi/fii Stze ? Shod* t* 1*1* • 

1. Use the TLK utility to send messages to a remote terminal 
using the following modes of operation. 

a. Single message mode 

b. Dialogue mode (use video screen option, when possible) 

c. Command file mode 



2. Establish a TLK dialogue mode session with a remote terminal, 

then try to use command file mode from both ends (local and 

remote) of the logical link. Check if it works from the 
remote terminal. 



3. Create a command file which contains the MCR BRO request and 
execute it using NFT on: 

a. Ihe local node 

b. Remote DECnet-llM node 

c. Remote DECnet-llM-PLUS node 



4. Kepeat Lab Exercise 3 using FTS with /LO and /AF switches. 
Analyze the FTSSYS.LOG file for possible errors. 

5. Use RMT to establish connection to a remote DECnet-llM/M-PLUS 
node; log onto the remote system. Run DEV/LOG (MCR) or SHO 
DEV (DCL) displays to see which HT: device you are using. 
Run RMD (MCR) or SHO SYS (DCL) displays to see the available 
memory allocation. Note how often the display is updated (the 
slower the communication path between the local node and the 
remote node, the longer the time intervals are) . 

6. Write two tasks in MACRO-11 or FORTRAN 77 that establish a 
logical link to each other. (Use optional data fields in CON 
and ACC calls to send short user messages. Display those 
messages on the local and remote terminals to make sure that 
the logical link was actually established.) 

7. Enhance the two tasks you have created in Lab Exercises 6 to 
include SND, REC, and XMI calls. Use corresponding examples 
in reference literature for additional information. 
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SOLUTIONS TO LAB EXERCISES 



dttf+ypttizi* 



1. 



a. See example 1 

b. See example 2, 3 

c. See example 4 

2. TLK cannot communicate with remote terminals (HT: ) 




\ 



a . NFT>COMMAND. CMD/EX 

b. NFT>N011M: : COMMAND. CMD/EX 

c. NFT>N011MP: : COMMAND. CMD/EX 



4. 



r 



NOTE 
The MCM task uses TTO: as a default; to 
execute the command procedure, be sure this 
terminal is logged in under a privileged 
account. 



-\ 



a. FTS>COMMAND/CMD/EX/AF:DD-MMM-YY:HH:MM/LO:LOG.FIL 

b. FTS>N011M: : COMMAND. CMD/EX/AF :DD-MMM-YY: HH:MM/LO 

c. FTS>N011MP: :COMMAND. CMD/EX/AF :: DD-MMM-YY: HH:MM/LO 



5. 



6. 



RMT 
Host: NODE 



+ht. 



Example Program Listings in Appendix jf 



7. Same as 6 



are 4-Q bs* 



■fe*:f 
Can/vo*- b* 
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INTRODUCTION 

DECnet software has an extensive Network Management interface 
that allows a user to configure, monitor, and test the network. 
This interface allows a network manager to access the Network 
Management Layer on the local or remote node by assigning an 
EXECUTOR to that node. 

This module details the Network Management interface. For 
comparison, information on systems other than DECnet-RSX is 
included. 

OBJECTIVES 

To manage a network, the specialist must be able to: 

• Use Network Control Program (NCP) commands fluently. 

• Bring network circuits up and down. 

• Change node, circuit, and line parameters. 

e Execute node, circuit, and line loopback tests- 

• Retrieve error information from counters displays and the 
cvcuu j.oggin 
performance. 

• Execute performance tests. 



evcuu xOyying j.aC ix 1 uy , auu COrre3pOn<a uiOoc «_G unS nSun'Or^ 



• Retrieve information from the Network Information Display 
(NTD) . 

RESOURCES 

DECnet-RSX System Manager's Guide 
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NETWORK MANAGEMENT LAYER 



Figure 1 shows the location and interfaces for the 
Management Layer in DIGITAL Network Architecture (DNA). 



Network 



NCP 



USER 
PROGRAM 



USER LAYER 



CIRCUIT 
WATCHER 



SYSTEM 
INDEPENDENT 
FUNCTION 
REQUESTS 



NETWORK 
MANAGEMENT 



NICE 



PROTOCOL 
COMMANDS ♦- — — -■ 

TO OTHER 

NODES 



NETWORK 
MANAGEMENT 
ACCESS ROUTINES 



NICE 

PROTOCOL NETWORK 

H MANAGEMENT 

LISTENER 



NETWORK 
MANAGEMENT 
COMMANDS 
FROM OTHER 
NODES 



LOC 



M CTUfrt p IS RilAMA/^CMCMT CI IMPTinWC 



CIRCUIT AND 
LINE SERVICE K" 
FUNCTIONS 



EVENTS TO 
OTHER NODES 



EVENT LOGGER 



F 



EVENTS FROM 
OTHER NODES 



NETWORK 
MANAGEMENT LAYER 



LOWER LAYERS 



SERVICE INTERFACE TO 
DATA LINK LAYER (DOWN- 
LINE LOAD, UPLINE DUMP, 
LINE TESTS, LINE STATE 
CHANGE, ETC.) 

CONTROL OVER LOWER LEVEL' 
FUNCTIONS (EXAMINE LINE 
STATE, TURN ON NSP, ETC.) 



SYSTEM-DEPENDENT CALLS TO 
APPLICATION LAYER AND LOCAL 
OPERATING SYSTEM FUNCTIONS 
(FILE ACCESS, LOGICAL LINK 
LOOPBACK, TIMER SETTING, ETC.) 



CONTROL INTERFACE TO READ 
EVENT QUEUES 



LEGEND: 

NCP - NETWORK CONTROL PROGRAM 



NICE - NETWORK INFORMATION AND 
CONTROL EXCHANGE 



I - 



VERTICAL ARROWHEADS INDICATE 
INTERFACES FOR FUNCTION REQUESTS 

HORIZONTAL ARROWHEADS INDICATE 
CONTROL INTERFACES 



Figure 1 Network Management Layer 
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BASIC FUNCTIONS 

• Configuring a DECnet and/or Packetnet System Interface 
(PSI) node 

• Configuring a network 

• Testing nodes and a network 

• Controlling node and network operations 

• Inspecting and monitoring nodes 

• Monitoring network activity 

Configuring a DECnet and/or PSI Node 

• PREGEN, NETGEN procedures 

• Configuration databases 

- Node database - CETAB.MAC file 
Down-line system loading database 
Down-line task loading database 

• Utilities 

- Network Control Program (NCP) 

- Configuration File Editor (CFE) 

- Virtual Network Processor (VNP) 

Configuring a Network 

• Down-line system loading 

• Modifying routing parameters 

• Modifying line and circuit parameters 

• Utilities 

- NCP 

- CFE 

- VNP 
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Testing Nodes and a Network 

• Loopback test 

• NTEST procedure 

• NCP Utility 

Controlling Node and Network Operations 

• Passwords and access control information 

• Down-line task loading and overlaying/up-line checkpointing 

• File transfer spooling management 

• Object specification 

• Utilities 

- NCP 

- CFE 

- VNP 

- FTS Queue Manager (FTQ) 

- Host Task Loader (HLD) 

- Satellite Task Loader (SLD) 

inspecting and Monitoring Nodes and a Network 

• Node, circuit, and line counters 

• Event logging 

• Performance testing 

• Trace (PSI only) 

• Network dump analysis 

• Utilities 

- NCP 

- Network Display (NTD) 

- Data Test Send/Data Test Receive (DTS/DTR) for DECnet 

- Remote Command Terminal Access (RMT/RVT*/RRS*/HOST*) 
Network Dump Analyzer (NDA) 

- Dump of the Running CEX (CEDUMP) 

♦Utility is not supported on DECnet-RSX. 
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NETWORK MANAGEMENT UTILITIES 



Table 1 Summary of Network Management and 
Supporting Utilities 

Operating System 



Utility 



RSX-11M 
VAX/VMS /M-PLUS 



RSX-11S IAS RT RSTS/E TOPS-20 



Network Control 
Program (NCP) 

Configuration 
File Editor (CFE) 

Configuration 

File Editor (NETGEN) 

Virtual Network 
Processor (VNP) 

Virtual Network 
Processor (SYSDPY) 

Network Display 
Program (NTD) 

Data Test 
Send/Receive for 
DECnet (DTS/DTR) 

Data Test 
Send/Receive for 
PS I (XTS/XTR) 



X(l) 



X X 



Remote M/M-PLUS 
Command Terminal 
(RMT) 



X X(2) 



Remote VAX/VMS 
Command Terminal 
(RVT) 



X(2) 



X(2) 



Remote RSTS/E 
Command Terminal 
(RST) 



X(2) 
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Table 1 Summary of Network Management and 
Supporting Utilities (Cont) 

Operating System 

RSX-11M 
Utility VAX/VMS /M-PLUS RSX-11S IAS RT RSTS/E TOPS-20 

Remote TOPS-20 X(2) X 

Command Terminal 

(HOST) 

Remote Command X 

Terminal (NET) 

Remote Command X 

Terminal (SET 

HOST) 

System Dump X 

Analyzer (SDA) 

Crash Dump X XX 

Analyzer (CDA) 

System Dump X 

Analyzer (MCBDA) 

M e £M r-t Dum" X (3 * X X X X(3^ 

Analyzer (NDA) 

Notes 

1. Provides a subset of functionality 

2. Nonsupported feature 

3. Part of SDA or MCBDA 
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Table 2 NCP Functions and Keywords 



Operating System 



RSX-11M 
NCP Functions VAX/VMS /M-PLUS RSX-11S IAS RT RSTS/E TOPS-20 



Load ing/Unload ing 

(SET/CLEAR/LOAD/ 

TRIGGER/TELL) 



Load/Unload a 
Network Software 



X X 



Load/Unload a 
Network Line 



X X 



Load/Unload a 
Network Circuit 



Change Line 
Status/Values 



X(l) 



X X 



Change Circuit 
Status/Values 



X(l) X(2) X(2) X 



Load/Unload a 
Network Process 

Trigger the Boot- 
strap of a Target 
Node 



Down-Line System 
Loading 

Control Functions 
(SET/TELL/LOOP) 

Multipoint Lines 

Remote Command 
Execution 



X(3) X 
XXX X 



Setting and 
Clearing Executor 
Parameters 
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Table 2 NCP Functions &n& Keywords (Cont) 



Operating System 



NCP Functions 



VAX/VMS /M-PLUS RSX-11S IAS RT RSTS/E TOPS-20 



Control Functions 

(SET/TELL/LOOP) 

(cont) 



Setting and 


X 


X 


X 


X 


X 


X 


X 


Clearing 
Passwords 
















Ro ut i ng 


X 


X 


X 


X 




X 


X 


Event Logging 


X 


X 




X 




X 


X 


Loopback 


X 


X 


X 


X 


X 


X 


X 


Displays (SHOW) 
















Line, Circuit, 
and Node 
Information 


X 


X 


X 


X(2) 


X(2) 


X 


X 


Network Process 
Information 




X 




X 


X 






Network 
Objects 


X 


X 




X 


X 


X 


X 


System 
Information 


X 


X 


X 


X 


X 


X 


X 


Logging 
Information 


X 


X 


X(l) 


X 




X 


X 


Counters 
Information 


X 


X 


X 


X 


X 


X 


X 


Line Counters 


X 


X 


X 


X 


X 


X 


X 


Circuit 
Counters 


X 


X 


X 






X 


X 


Node and Execu- 
tor Counters 


X 


X 


X(l) 


X 


X 


X 


X 
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Table 2 NCP Functions and Keywords (Cont) 

Operating System 



NCP Functions 



RSX-11M 
VAX/VMS /M-PLUS RSX-11S IAS RT RSTS/E TOPS -20 



Node Name 
Information 
(SET/CLEAR/ ZERO) 

Changing a Node 
Name 

Alias Name 
Information 



Notes 

1. Provides a subset of functionality 

2. Concept of a circuit is not implemented 

3. Tributary only 
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>NCP 

NCP>SET HOST ADDR 35 

SET »HOST ADDR 35 
NCP — Set not accepted? unrecosnised command 
NCP> 
NCP>SET HOST NODE 35 

SET »H0ST NODE 35 
NCP — Set not. accepted* unrecosnized command 
NCP>HELP SET 
The format of the SET command isi 

SET component component-options 

Component types are? 

ALIAS 

CIRCUIT 

EXECUTOR 

LINE 

LOGGING 

vmnr 
ItUl'C 

OBJECT 

PROCESS 

SYSTEM 

For more help use* 

HELP component-type 
HELP SET component-type 

Example I NCP HELP Session for Setting Host Nod< 

(Sheet 1 of 2) 
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NCP>HEK\K\LP SET EXECUTOR 

Use the SET EXECUTOR command to create or modify executor node parameters 

The format is? 

SET EXECUTOR parameters 

Parameter tapes 3reJ 

HOST STATE 

NODE TRANSMIT PASSUORD 

RECEIVE PASSUORD VERIFICATION CSTATE3 

ROUTING TIMER 

SEGMENT BUFFER SIZE 

For more help use? 

HELP EXECUTOR 

HELP SET EXECUTOR parameter-tape 

NCFOSET EXECUTOR HOST 35 
NCP>"Z 



Example 1 NCP HELP Session for Setting Host Node 

(Sheet 2 of 2) 
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DATABASES AFFECTED BY NETWORK MANAGEMENT UTILITIES 

Network software has two databases: 

# Permanent (file) 

• Volatile (core) 

If the volatile database is affected by the network management 
utility, the effect of such change is known and can be used 
immediately. But if the system or network is restarted, those 
changes are lost. When changes are made to the permanent 
database, they become known to the system and can be used only 
after restarting the system or network. 
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Table 3 Volatile and Permanent Databases 
and Corresponding Utilities 



Utility 


Command 


VAX/ 
VMS 


NCP 


SET/CLEAR 
SHOW/ ZERO 


Vol. 


NCP 


DEFINE/ 
PURGE/LIST 


Perm 


CFE 


DEFINE/ 
PURGE/LIST 




NETGEN 


DEFINE/ 
PURGE/LIST 





Databases for Systems 



RSX-11M RSX- 

/M-PLUS US IAS RT RSTS/E TOPS -20 



Vol. 



Perm. 



Vol. Vol. "Vol. Vol. Vol. 



Perm. Perm 



Perm. Perm. 
(1) 



Perm. 



Perm. 



VNP 



NETGEN 



SET/CLEAR/ Vol. 



SHOW 

DEFINE/ 
PURGE/LIST 



(4) 



Vol. Vol. 

(2), (3) (4) 



Vol. 
(4) 



Notes 



1. Used on the host system (VAX/VMS, RSX-11M/M-PLUS, IAS) to 
modify the permanent database for RSX-11S system image 
before running the Virtual Network Processor (VNP). 

2. Used to modify the RSX-11M/S system image to activate a 
network on the system image file. 

3. VNP cannot be used against the RSX-11M-PLUS system image. 

4. VNP (NETGEN) in the host (VAX/VMS, RSX-11M/M-PLUS, 
TOPS-20) is used to modify the RSX-11S system image. 
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NODE, CIRCUIT, AND LINE IDENTIFICATION 

• A DECnet node is identified by node address, which is 
unique in the network, and by name, which is local to the 
node (executor) and/or to a user (alias) * The maximum node 
address is 1023. 

• A PSI node is identified by a 12-character Data Terminal 
Equipment (DTE) address (supplied by the PPSN vendor) , and 
by name, which is local to the node. The first 4 
characters in the DTE address is an international code for 
a PPSN. 

Example: 

3110-TELENET 
2342-PSS 

• A circuit is a logical path between two adjacent nodes or 
DTEs . A DECnet circuit is identified as: 

devicetype-controllernumber [-unitnumber] . [tributary-number] 

Exampl e t 

DMC-1 
DMP-i. 3 
DLM-0.1 
KDP-0-0. 3 

• A PSI Permanent Virtual Circuit (PVC) is identified by 
name. 

Example: 

ABCDEF 

DLM-1.0 (Special case for DECnet using PSI PVC) 
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• A line is a physical path between two adjacent nodes. It 
is identified as: 

d ev ice type-con tr oiler number [-unitnumber] 

Example: 

DUP-0 

SDP-1 

KMXH3-1 

DMP-1 
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DECnet Node Types 

• Executor — A node that a given NCP command is executed on 

• Command — A node that an NCF command is initiated from 

• Host — A node that a particular application depends on 
(for example, remote command terminal, down-line system 
loading, down-line task loading, and so on) 

• Target — A node that the host addresses to 

DECnet and PSI Types 

• Local — A node that a particular procedure is initiated 
from (operator command, setting up Switched Virtual Circuit 
(SVC) , and so on) 

• Remote — A node that the local request addresses to 

EXECUTOR, CiRCUiT, AND UNE STATES 

• Executor states 

ON — Normal network activity is allowed 

- OFF — No network activity is allowed 

- SHUT — Temporary state before the OFF state; only 
existing network activity is allowed (for example, 
existing logical links are still active, but no new 
logical link is allowed) 

• Circuit states (Table 4) 

• Line states 

ON — Line is active 

- OFF — Line is inactive (stopped) 

- SERVICE — Line is in maintenance mode 

- CLEARED — Line is not loaded 
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Table 4 Circuit States and Substates 



State 



Substate 



Meaning 



OFF 
ON 



None 

- RUNNING 

- STARTING 

- REFLECTING 

- AUTOSERVICE 

- AUTOLOADING 

- AUTODUMPING 

- AUTOTRIGGERING 

- LOADING 

- DUMPING 

- LOOPING 

- TRIGGERING 

- SYNCHRONIZING 



The circuit is not usable. 

The circuit is in normal use 

The circuit is in the DDCMP 
initialization cycle. 

The circuit is in use for 
passive loopback testing. 

The circuit is reserved for 
automatic service use. 

The circuit is in use for 
automatic loading. 

The circuit is in use for 
automatic dumping. 

The circuit is in use for 
automatic triggering. 

The circuit is in use for 
loading. 

The circuit is in use for 
dumping . 

The circuit is in use for 
active circuit loopback 
testing . 

The circuit is in use for 
triggering. 

The circuit is trying to 
synchronize with its 
adjacency. 
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Table 4 Circuit States and Substates (Cont) 



State 



Substate 



Meaning 



SERVICE 



- IDLE 



- REFLECTING 



- LOADING 



- DUMPING 



- LOOPING 



- TRIGGERING 



CLEARED 



Tne circuit is reserved ror an 
active service function. 

The circuit is in use for 
passive loopback testing. 

The circuit is in use for 
load ing . 

The circuit is in use for 
dumping . 

The circuit is in use for 

The circuit in use for 
triggering . 

The corresponding line is 
not loaded. 
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EXAMPLES OF NCP USAGE FOR NODE, CIRCUIT, AND LINE 

All NCP SHOW commands cause output to be displayed at the 
user's terminal. However, you can direct output to any output 
file at the local node. To do so, append the keyword TO followed 
by the output file specification. For example, to direct output 
to the file NANOOK. LST, type: 

NCP> SHOW NODE NANOOK TO NANOOK. LST - 

If the specified output file does not already exist, NCP 

creates a new file. If the specified file already exists, NCP 

appends the output to that file. NCP does not create a new 
version of the existing output file. 



Active nodes summary as of l-NOV-83 13:51:16 
Executor node » 62 (CASTOR) 

State - On, Identification ■ RSX-11M-PLUS V2.1 



Remote 
Node 

1 (VORTEX) 

21 (ORAC) 

30 (PHOEBE) 

41 (SADE) 

42 (GNAT) 

43 (SHALOM) 

44 (WE3STR) 

45 (MARAT) 
47 (BANZAI) 

60 (KERMIT) 

61 (QUASAR) 

65 (RSXHUB) 

66 (THEFLY) 

67 (RUNE) 

68 (BAXTER) 

69 (ADVISE) 

70 (GUIDO) 

71 (VAXUUM) 

76 (SPIT20) 

77 (ZK20FE) 
81 (TITAN) 
90 (METEOR) 

94 (ROYAL) 

95 (BEING) 
100 (METOO) 

102 (LEGO) 

103 (POSSUM) 
105 (ATOM) 
108 (BOOKIE) 



State 

Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 
Reachable 



Active 

Links Delay Circuit 
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UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 
UNA-0 



Next 
Node 

1 (VORTEX) 
21 (ORAC) 
30 (PHOEBE) 
41 (SADE) 
152 (ALGOL) 
151 (KOBAL) 
44 (WEBSTR) 
4 5 (MARAT) 
47 (BANZAI) 

60 (KERMIT) 

61 (QUASAR) 
95 (BEING) 

66 (THEFLY) 

67 (RUNE) 

68 (BAXTER) 

69 (ADVISE) 

70 (GUIDO) 

71 (VAXUUM) 
185 (EIFFEL) 
185 (EIFFEL) 
81 (TITAN) 
90 (METEOR) 

94 (ROYAL) 

95 (BEING) 
100 (METOO) 
102 (LEGO) 
177 (MAGIC) 
213 (WOMBAT) 
108 (BOOKIE) 



Example 2 NCP> SHOW ACTIVE NODES. 
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NOTE 
If your node is a nonrouting node and you 
wish to determine which nodes are reachable, 
you must have the SHOW ACTIVE NODE command 
executed at an adjacent full-routing node. 



Circuit summary as of l-NOV-83 13:52:12 
Circuit = UNA-0 
State = On 
Example 3 NCP> SHOW CIRCUIT UNA-0 

Known lines summary as of l-NOV-83 13:51:46 

Line State 

UNA-0 On 

PCL-0 Cleared 

DMC-0 Cleared 

DMC-1 Cleared 

Ex2™r>l^ * wrD\ cnnw vmaum t tmpq 
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All aliases summary as of l-NOV-83 13:52:33 



Alias 








Name 


Scope 




Destination 


A 


Terminal 


TT63- 


: ALIEN/PETTENGILL/. . . 


M 


Terminal 


TT63- 


i , QUASAR/PETTENGILL/... 


K 


Terminal 


TT63; 


: KERMIT/PETTENGILL/. . . 


R 


Terminal 


TT63: 


: RUNE/PETTENGI LL/ . . . 


CASTOR 


Global 




CASTOR/DECNET/ . . . 


DOC 


Global 




DOC/DECNET/... 


KERMIT 


Global 




KERMIT/DECNET/... 


POLLUX 


Global . 




POLLUX/DECNET/... 


QUASAR 


Global 




QUASAR/DECNET/ . . . 


RSXHUB 


Global 




RSXHUB/DECNET/... 


RUNE 


Global 




RUNE/DECNET/... 



Example 5 NCP> SHOW ALL ALIASES 



Global aliases are aliases set by the system manager that may 
be used by all tasks and users. Local aliases are those set by 
nonprivileged user and apply only at the user's terminal. 
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LOOPBACK TESTING 

There are two types of loopback tests for the DECnet: 

s Node level lookback test 

• Circuit level loopback test 

Figures 2 and 3 illustrate the node and circuit level loopback 
test components. 
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Figure 2 Node Level Loopback Test Components 
(NCP> LOOP NODE ZIRCON) 
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Figure 3 Circuit Level Loopback Test Components 
(NCP> LOOP CIRCUIT DMC-0) 



NOTE 
Because of physical buffer limitations a 
DMC-11 device cannot successfully do a loop 
circuit directly. The user must do the 
following : 

1. NCP> SET NODE XXX CIRCUIT DMC-0 

NCP> LOOP NODE XXX 



2. NCP> LOOP CIRCUIT DMC-0 COUNT 
number less than 50) 



<50' 



(any 
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EVENT LOGGING AND MONITORING 

Figure 4 shows the event logging Interface in DECnet 
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Figure 4 Event Logging Architectural Model 
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Table 5 lists the supported event classes. 

Table 5 Network Event Classes 

■-■■■■ r 

Event Class Source of the Event 

Network Management Layer 

1* Applications Layer 

2 Session Control Layer 

3 Network Services Layer 

4 Routing Layer 

5 Data Link Layer 

6 Physical Link Layer 

7-31* Reserved for other common classes 

32-63* Reserved for RSTS/E systems 

64-95 RSX-11 system specific 

96-127* Reserved for TOPS-20 systems 

128-159* Reserved for VMS systems 

160-479* Reserved for future use 

*DECnet-RSX does not log events for these classes. However, 
processed events in these classes from other remote nodes are 
logged . 



NOTE 
For additional information on network events, 
refer to Appendices C and D of the 
DECnet-RSX System Manager's Guide . 
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Example 6 shows some events as they appear on the system 
console. 



Event type 4.7» Circuit down - circuit fault 
Occurred 23-N0v-S3 14:27:20 on node 65 (RSXHUB) 
Circuit DMC-1 
Line synchronization lost 



Event ta^e 4,7» Circuit down - circuit fault 
Occurred 23-NOV-83 14: 43: 54 or. node 65 (RSXHUB) 
Circuit DMC-1 
Adjacency listener receive timeout 



Event type 4.7» Circuit down - circuit fault 
Occurred 23-NQU-83 19:58:26 on node 45 (RSXHUB) 
Circuit DMC-0 
Adjacency listener receive timeout 



Event type 4.7> Circuit down - circuit fault 
Occurred 28-N0V-83 08:22:18 on node 65 (RSXHUB) 
Circuit DMC-1 
Adjacency listener receive timeout 



Event type 4,7» Circuit down - circuit fault 
Occurred 28-N0V-83 11:54:41 on node 65 (RSXHUB) 
Circuit DMC-2 
Line synchronization lost 



Event type 4.7? Circuit down - circuit fault 
Occurred 28-N0U-83 11:54:51 on node 65 (RSXHUB) 
Circuit DMC-2 

Example 6 Event Logging on CO: 
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NODE, CIRCUIT, AND LINE COUNTERS 

Some events, when detected, appear in the node, circuit, and 
line counters. 



Active nodes counters as of l-NOV-83 13:53:08 

Executor node » 62 (CASTOR) 

39106 Seconds since last zeroed 

50489 Bytes received 

50376 Bytes sent 

6897 Messages received 

6967 Messages sent 

36 Connects received 

36 Connects sent 

Response timeouts 

Received connect resource errors 

8 Total maximum logical links active 

9 Aged packet loss 

Node unreachable packet loss 

Node out-of-range packet loss 

1 Oversized packet loss 
Packet format error 

Partial routing update loss 

Verification reject 

4 Node maximum logical links active 

Total received connect resource errors 

Remote node ■ 21 (ORAC) 

>65534 Seconds since last zeroed 

1722088 Bytes received 

6169 Bytes sent 

6988 Messages received 

6976 Messages sent 

11 Connects received 

2 Connects sent 

Response timeouts 

Received connect resource errors 

2 Node maximum logical links active 

Remote node * 30 (PHOEBE) 

No information 
Remote node * 41 (SAOE) 

No information 
Remote node * 42 (GNAT) 

No information 

Example 7 NCP> SHOW ACTIVE NODE COUNTERS 
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Active circuits counters as of l-NOV-83 13:53:35 

Circuit = UNA-0 

39438 Seconds since last zeroed 

94005 Terminating packets received 

100626 Originating packets sent 

Corruption loss 

752 Transit packets received 

751 Transit packets sent 

Transit congestion loss 

Circuit down 

Initialization failure 

56993662 Bytes received 

6314583 Bytes sent 

574818 Data blocks received 

113205 Data blocks sent 

User buffer unavailable 

Example 8 NCP> SHOW ACTIVE CIRCUIT COUNTERS 
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Line counters as of l-NOV-83 13:53:58 



Line = UNA-0 



39452 

62896709 

7689281 

55791183 

578286 

113355 

483518 

2209 

276 

140 

1 


9 



2812 




Seconds since last zeroed 

Bytes received 

Bytes sent 

Multicast bytes received 

Data blocks received 

Data blocks sent 

Multicast blocks received 

Blocks sent, initially deferred 

Blocks sent/ single collision 

Blocks sent, multiple collision 

Send failure, including: 

Frame too long 
Collision detect check failure 
Receive failure, including: 

Block check error 

Framing error 
Unrecognized frame destination 
Data overrun 
System buffer unavailable 



Example 9 NCP> SHOW LINE UNA-0 COUNTERS _ 
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Performance Analysis and Testing NTD Facility 

The Network Information Display (NTD) program allows you to 
observe and evaluate allocation of the network resources on the 
designated node (local or remote) on a periodic basis. Example 10 
shows an NTD display. 




M 



©15-DEC-83 10:44:41©NodertlRC0N< 231) ZIRCON-ENCRUSTED-TUEEZERS 
OO RSX-llMt Non-Routins Node* DECnet V4.0 

©LNKS©2 / 10 XXXXXXXX! Alloc Fails: 

© CCB 4/10 XXXXXXXXXXXXXXXX! 00 

©SDB 0/11 

LDB 4/9 XXXXXXXXXXXXX !— : ©0 

© 

Known Circuits* Network Tasks! 

Circuit Cost Size AdJ Node/Status Task TI Links MBX XMT RCV 

©DttC-0 ©5 576 RSXHUBC 65) ©NTD..» COO: ©1 

Q Q »..NTB TTO: 10 1 

Example 10 NTD Display for a Node 
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NTD displays the following information: 

© Correct date and time 

© Node name and address 

© Node identification 

O Logical links 

© Number of resources currently in use 

O Total number of resources generated in the system 

O Number of resources in use (scaled) 

O Highest resource usage recorded 

O Number of allocation failures for each resource type 

© Communication control buffers 

© -Small data buffers 

© -Large data buffers 

© Total allocation failures 

© - Remote adjacent node name(s) and address (es) 

© -Circuit(s) in or available for use 

© Known cost to the adjacent node 

© Maximum message size 

© Currently active network tasks 

© Information about currently active network tasks 
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DTS/DTR Tests 

A popular technique used for performance analysis is Data Test 
Send/Data Test Receive (DTS/DTR) testing, 

DTS/DTR are performance utilities supplied on the DECnet 
Distribution Kit. They allow you to perform the following types 
of tests: 

• Connection 

• Data 

• Disconnection 

• Interrupt 

Example 11 demonstrates DTS/DTR testing from a VAX/VMS node to 
an RSX node. For an example of DTS/DTR testing between RSX nodes, 
see the section on Testing the DECnet-RSX Software in the 
Installation and Checkout module. 

In the example, note that the default value for the /SPEED 
qualifier is 1 million bps . 



NOTE 
DTS/DTR must be installed on both systems for 
the test to work successfully. 
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% BNETICP 

NETICP.COM 
DECne.t Installation Checkout Procedure 

Remote nod* for test (node nam): ZIRCON 

Tape of remote node (VAX» RSXi IAS» RTr RSTS» DEC20): RSX 
Speed of line for statistics (baud): 56000 

DTS/DTR tests exercise the basic NSP level capabilities of a DECnet 
product by reauestins common task-to-task, communication functions. 
Ue will first test DTS to OTR on the local node and then test it 
to the reeote node. 

DTS Version 2.00 initiated on 14-DEC-1983 15:31J05.46 

CONNECT/TYPE-ACCEPT/NORETURN *3.Ji.wa. 46 

ZDTS-I-CINREJ* connect aborted* nsp reason is 00000004 

DISCONNECT/TYPE»ABORT/RETURN*STANDARD 

2DTS-I-CINREJ* connect aborted? nsp reason is 00000004 

DATA/TYPE-SINK/SIZE-128/SEC0NDS-10 

ZDTS-I-CINREJ* connect aborted* nsp reason is 00000004 

Test parameters! 

Test duration (sec) 10 

Tarset nodename *' 

Line speed (baud) 1000000 

Message size (bates) 128 

Summary statistics! 

Total messases XHIT RECV 

Total bates XHIT 

Messages per second .0.0 

Bates per second 

Line thruput (baud) 

Z Line utilization 0.0 
EXIT 

DTS terminated on H-DEC-1983 13:31127. 4? 

DTS version 2.00 initiated on H-DEC-19&3 15:3t!29.01 
/N0DENAME»ZIRCQN/SPEED-560O0/STATISTICS/PRINT/NODISPLAY- 

-! Connect tests 

CONNECT/TYPE»ACCEPT/NuRETURN 
%DTS-S-NORMALf nor»3l successful completion 
CONNECT/TYPE»ACCEPT/RETURN-STANDARD 
XDTS-S-NORNALt normal successful coepletion 
CONNECT/TYPE«ACCEPT/RETURN«RECEIVED 
%DTS-S-NQRMAL» noreal successful coepletion 
C0NNECT/TYPE*REJECT/NORETURN 
ZDTS-S-NORMALf normal successful completion 
CONNECT/TYPE»REJECT/RETURN-STANDARD 
%DTS-S-NORHAL» normal successful completion 
CONNECT/TYPE»R£JECT/RETURN-RECEIVED 
XDTS-S-NORMALf normal successful completion 
- 1 

-! Disconnect tests 
- 1 

DISCONNECT/TYPE'SYNCHRONOUS/NORETURN 

Example 11 DTS/DTR Test Between DECnet/VAX and DECnet-llM 

(Sheet 1 of 4) 
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%DTS-S-NQRMAL» normal successful completion 

DISCONNECT/TYPE*SYNCHRONOUS/RETURN»STANDARD 

2DTS-S-N0RMAL* normal successful completion 

DISCONNECT/TYPE»SYNCHRONOUS/RETURN«RECEIVED 

ZDTS-S-NQRMAL* normal successful completion 

DISCONNECT/TYPE-ABORT/NORETURN 

%BTS-S-NORMAL» normal successful completion 

BISCONNECT/TYPE«ABQRT/RETURM«STANBARB 

SDTS-S-NORHAL* normal successful completion 

nT SCONNECT /TYPE* ABORT/ RETURN "RECEIVED 

2BT3-S-N0RMAL* normal successful completion 

- 1 

-! Date tests 

- 1 

DATA/TYPE»SINK/SIZE»128/SEC0NDS-10 

ZDTS-S-NORMAL» normal successful completion 

Test parameters* 

Test duration (sec) 10 
Tarset nodename 'ZIRCON* 
Line speed (baud) 56000 
Messase size (bates) 123 

Summary statistics* 

Total messases XMIT 107 RECV 

Total bates XMIT 13696 

Messages per second 10.7 

Bates per second 1370 

Line thruput (baud) 10957 

% Line utilization 19.5 
DATA/TYPE-SEQUENCE/SI2E-128/SEC0NDS-10 
ZDTS-S-NORMAL* normal successful completion 

Test parameters! 

Test duration (sec) 10 

Tarset nodename 'ZIRCON* 

Line speed (baud) 56000 

Message size (bates) 128 

Sumaara statistics* 

Total messases XMIT 108 RECV 

Total bates XMIT 13824 

Messases per second 10*8 

Bates ^9r second 1382 

Line thruput (baud) 11059 

X Line utilization 19.7 
DATAVTYPE«PATTERN/SIZE»128/SEC0NDS=10 
ZDTS-S-NORMALt normal successful completion 

Test parameters* 

Test duration (sec) 10 

Tarset nodename 'ZIRCON' 

Line speed (baud) 56000 

Messase size (bates) 128 

Summara statistics! 

Total messases XMIT 101 RECV 

Total bates XMIT 12928 

Messases ^tr second 10.1 

Bates per second 1293 

Line thruput (baud) 10342 

Z Line utilization 18.4 
DATA/TYPE»ECH0/SIZE»128/SEC0NDS»10 
2DTS-I-BADDATLEN* not enough data sent/received 



Example 11 



DTS/DTR Test Between DECnet/VAX and DECnet-llM 
(Sheet 2 of 4) 
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Test duration (sec) 10 

Tarset nodenaae 'ZIRCON' 

Line speed (baud) 56000 

Messaae size (bates) 128 



Suaaara statistics! 
Total aessases XMIT 
Total bates XMIT 
Messages per second 
Bates per second 
Line thruput (baud) 
7. Line utilization 



Interrupt tasts 



61 

14592 

11.4 

1459 

11674 

20.8 



RECV 



53 



INTERRUPT/TYPE»SINK/SIZE«16/SEC0NDS»10 
ZDTS-S-N0RMAL* noraal successful coapletion 

Tast par3aeters! 

Tast duration (sec) 10 

Tarset nodeii3ae "ZIRCON* 

Line speed (baud) 56000 

Hessaae size (bates) 16 



Suaaara statistics! 

Total aessases XMIT 141 RECV 

Total bates XHIT 

Messages per second 

Bates per second 

Line thruput (baud) 

Z Line utilization 
INTERRUPT/TYPE»SEQUENCE/SIZE»16/SEC0NDS«10 
ZDTS-S-N0RMAL* noraal successful coapletion 



141 

2256 

14.1 

226 

1805 

3.2 



Test paraaeters! 

Test duration (sec) 10 

Tarset nodenaae 'ZIRCON* 

Line speed (baud) 56000 

Messase size (bates) 16 

Suaaara statistics! 

Total aessases XHIT 134 RECV 

Total bates XMIT 2144 

Messages per second 13.4 

Bates per second 214 

Line thruput (baud) 1715 

2. Line utilization 3.0 
INTERRUPT/TYPE»PATTERN/SIZE-16/SEC0NDS«10 
ZDTS-S-NORMALr noraal successful coaptation 

Test P3raaeters. 

Test duration (sec) 10 

Tarset nodenaae 'ZIRCON* 

Line speed (baud) 56000 

Message size (bates) 16 

Suaaara statistics! 

Total aessases XMIT 135 RECV 

Total bates XMIT 2160 

Messages per second 13.5 

Bates per second 216 

Line thruput (baud) 1728 

X Line utilization 3.0 
INTERRUPT/TYPE-ECHO/SIZE*16/SECONDS»10 
«BTS-S-NORMAL» noraal successful coapletion 

Example 11 DTS/DTR Test Between DECnet/VAX anel DECnet-llM 

(Sheet 3 of 4) 
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Test parameters* 

Test duration (see) 10 

Taraet nodename 'ZIRCON 8 

Line speed (baud) 56000 

ttessaae size (bytes) 16 

Suttaary statistics! 

Total aessases XHIT 81 RECV 80 

Total bates XMIT 2376 

Hessases per second 16.1 

Bates per second 258 

Line thruput (baud) 2061 

7. Line utilization 3*6 
EXIT 

DTS terminated on l4-DEC-i?83 15.33.34.33 

Perfora soae sieple file procedures with DCL. 

Create a file and copy it to the remote node. 

Copy it back and compare the file after the round trip to 

see if there were any changes* The file is copied back with 

both COPY and TYPE/OUT*. 

The file is deleted on the reaote node after the test. 



Example 11 



DTS/DTR Test Between DECnet/VAX and DECnet-llM 
(Sheet 4 of 4) 
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E XERCIS ES . 

Select the best answers for each of the following statements, 

1- When the Executor is assigned to a remote node, a logical link 
connection is established from the: 

a. Local Network Management Layer and the remote Network 
Management Layer 

b. Local End Communication Layer and the remote End 
Communication Layer 

c. Local Network Applications Layer and the remote Network 
Applications Layer 

d. No Logical Link is created 

2. NCP allows the user to modify the: 

a. Volatile DECnet down-line system loading database 

b. Permanent and volatile DECnet database 

c. Volatile DECnet database only 

d. Permanent DECnet database only 

3. The maximum node address that can be assigned on a Phase IV 
DECnet node is: 

a. 1024 

b. 255 

c. 1023 

d. 2048 
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4. The Data Test Send and Data Test Receive tasks (DTS/DTR) will 
operate : 

a. Only between two DECnet-RSX nodes 

b. Between any DECnet nodes 

c. Only between a DECnet-RSX node and a DECnet/VAX node 

d. None of the above 

5. The loopback node name is used to: 

a. Replace circuit-level loopback tests with node-level 
loopback tests 

b. Replace the current name of the host node 

c. Replace line-level loopback tests with node-level loopback 
tests 

d. Simulate two nodes when there is only one 

6. The loopback- mirror is used to: 

a. Record all loopback tests in a file 

b. Reflect back the loopback requests only for node-level 
loopback tests 

c. Give a current status of all circuits, and lines on the 
host node 

d. a and b only 

7. All network events are classified by: 

a. Priority of the task issuing the event 

b. Class of event 

c. Operating system currently running 

d. Network Layer issuing the event 
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8. Events detected on a node can be dispatched to: 

a. The console device 

b. The event logger data file 

c. A remote node 
d . A monitor task 

9. The NCP command to stop all activities on a DECnet-RSX node 
is: 

a. SET NODE STOP 

b. SET EXECUTOR STATE STOP 

c. SET EXECUTOR STATE OFF 

d. SET NODE OFF 

10. The CFE command to create a new node entry into the database 
is: 

a. SET NODE ROGER ADDRESS 300 

b. DEFINE NODE 300 NAME ROGER 

c. DEFINE ADDRESS 300 NAME IS ROGER 

d. SET NAME ROGER ADDRESS 300 
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SOLUTIONS 

Select the best answers for each of the following statements. 

1. When the Executor is assigned to a remote node, a logical link 
connection is established from the: 

a. Local Network Management Layer and the remote Network 
Management Layer 

Local End Communication Layer and the remote End 
Communication Layer 

c. Local Network Applications Layer and the remote Network 
Applications Layer 

d. No Logical Link is created 

2. NCP allows the user to modify the: 

(a^S Volatile DECnet down-line system loading database 

b. Permanent and volatile DECnet database 
(cy Volatile DECnet database only 

d. Permanent DECnet database only 

3. The maximum node address that can be assigned on a Phase IV 
DECnet node is: 

a. 1024 

b. 255 



© 



1023 



d. 2048 
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4. The Data Test Send and Data Test Receive tasks (DTS/DTR) will 
operate: 

a. Only between two DECnet-RSX nodes 

(bjh Between any DECnet nodes 

c*. Only between a DECnet-RSX node and a DECnet/VAX node 

d. None of the above 



5, The loopback node name is used to: 

4y- Replace circuit-level loopback tests with node-level 
loopback tests 

b. Replace the current name of the host node 

c. Replace line-level loopback tests with node-level loopback 
tests 

d. Simulate two nodes when there is only one 

6. The loopback mirror is used to: 

a. Record all loopback tests in a file 

Reflect back the loopback requests only for node-level 
loopback tests 

Give a current status of all circuits, and lines on the 
host node. 

a and b only 



7. All network events are classified by: 

a. Priority of the task issuing the event 

Qdj Class of event 

c. Operating system currently running 

d. Network Layer issuing the event 
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8. Events detected on a node can be dispatched to: 

"{^y~ ' I * ie cons °l e device 

~(y The event logger data file 

~(Fy A remote node 

•^dJr A monitor task 

9. The NCP command to stop all activities on a DECnet-RSX node 
is: 

a. SET NODE STOP 

b. SET EXECUTOR STATE STOP 
^0^ SET EXECUTOR STATE OFF— 

d. SET NODE OFF 

10. The CFE command to create a new node entry into the database 
is: 

a. SET NODE ROGER ADDRESS 300 

(b^ DEFINE NODE 300 NAME ROGER 

c. DEFINE ADDRESS 300 NAME IS ROGER 

d. SET NAME ROGER ADDRESS 300 
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LAB EXERCISES 



1. Using NCP, display the following information: 

a. Executor characteristics 

b. System characteristics 

c. Circuit status 

d. Known nodes 

e. Active line characteristics 

f. Remote node known circuit counters 

2. Given a network configuration, perform the following tests: 

a. Node level loopback test 

b. Circuit level loopback test 

c. Line level loopback test 

Display node. circuit. and line counters. Analyze for 
possible errors. 

3. Run an NTD display and analyze the display data. How many 
logical links are active? What is the path cost to remote 
node? What circuit is used to get there? Which network tasks 
have receive outstanding? Repeat the same operation for the 
remote DECnet-RSX node. 

4. Perform a DTS/DTR test for a given configuration. 

5. Look at the event logging outputs on your system console and 
analyze the information displayed. How many times did the 
circuits go down or up? How many accesses to the node were 
rejected? 
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SOLUTIONS TO LAB EXERCISES 



i. 



2. 



a. NCP SHO EXE CHAR 

b. NCP SHO SYS CHAR 

c. NCP SHO KNOWN CIR STA 

d. NCP SHO KNOWN NODES 

e. NCP SHO ACT LINES 

f . NCP SHO NODE XXX COUNT 



a. NCP ZERO EXE COUNT 
NCP LOOP EXEC 

NCP SHO EXEC COUNT 

b. NCP ZERO CIR XXX -N COUNT 
NCP LOOP CIR XXX-N 

NCP SHO CIR XXX-N COUNT 

c. NCP ZERO LINE XXX-N COUNT 
NCP LOOP LINE XXX-N 

NCP SHO LINE XXX-N COUNT 



3. 

a. NTD 

b. NTD NODE: : 

4. NTEST 

5. Example 6 
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INTRODUCTION 

The Packetnet System Interface (PSI) is designed to follow the 
recommendations produced by International Telephone and Telegraph 
Consultative Committee (CCITT) . Many European countries and 
Canada already provide Packetnet service. In the U.S., common 
carriers such as TELENET and TYMNET also provide such service. 

The major advantages of Packetnet include cost saving for 
medium traffic, rates independent of distance, flexibility, 
network management provided by the common carriers, and an ability 
to communicate with other vendors' equipment. 

In this module, the basic concepts behind Packetnet are 
discussed. In the appendixes, the details of the protocols used 
are presented. 



OBJECTIVES 

Upon completion of this module, the specialist should be able 



to: 



• Specify the differences between X. 25, X.3, X.28, and X. 2S 
protocols. 

• Define X. 25 Level 1, Level 2, and Level 3. 

• List the advantages provided by Packetnet. 



RESOURCES 

1. Martin, James. Computer Networks and Distributed Pro- 
cessing . Englewood Cliffs, NJ: Prentice-Hall, 1981. 

2. DNA X.25 Packet Level Specification 

3. DNA X.25 Frame Level Specification 
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REASONS FOR PACKET SWITCHING 

• International standard recommended by CCITT. The standards 
are known as the X series. 

• Countries such as France (TRANSPAC) , Canada (DATAPAC) , the 
United Kingdom (PSS) , Germany (DATEX-P) , Holland, (DNl) , 
and others are or will be providing Public Data Network 
service based on these recommendations. 

• Public Packet Switching improves the efficiency of a 
transmission line by sharing the line among many users, 
thus reducing the amount of time the line is idle. 

• Cost does not depend on connection time and distance as in 
dial-up or leased lines. 

• Cost is made up of a fixed portion plus a variable portion 
depending on the volume of data. 

• Public Data Networks cover a wide area and have extensive 
backup (alternative routine) capability. Network 
management is done at Network Control Centers. The user 
does not need to worry about managing the network. 

• Reliability and flexibility are expected to be high. 

• Users can interface different vendors 5 equipment as long as 
they adhere to these standards. 

• Terminals, even asynchronous dumb terminals, can be 
connected to the networks. 



DECnet-RSX PACKETNET SYSTEM INTERFACE 



CONCEPTS IN PACKET SWITCHING 
X.25 Recommendation 

• The end user does not need to know anything about the 
internal mechanism used in Public Packet Switched Networks 
(PPSN). 

• The X.25 recommendation specifies the interface between the 
Data Terminal Equipment (DTE) and the Data Circuit 
Terminating Equipment (DCE). Figure 1 illustrates this 
relationship. 



PACKET-MODE DTE 
(COMPUTER) 



X.25 

DEFINES THIS 
INTERFACE 




PACKET-MODE DTE 
(COMPUTER) 



PACKET-MODE DTE 
(COMPUTER) 



X.25 

DEFINES THIS 
INTERFACE 



Figure 1 DTE/DCE Relationship 
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• The X. 3, X. 28 r and X. 29 recommendations together specify 
how to control asynchronous terminals connected directly to 
the network. Together, these protocols define the 
Interactive Terminal Interface (ITI). 



PACKET-MODE DTE 
WITH X.29 SUPPORT 



X.25 DEFINES 
THIS INTERFACE 



X.29 DEFINES 
PROCEDURES FOR 
EXCHANGE OF 
INFORMATION 
ACROSS HERE 




NONPACKET-MODE 

DTE 

(START-STOP TERMINAL) 



X.28 DEFINES 

THIS LINK PAD 

'DEFINED SY X "** 



PAD (DEFINED BY X.3) 



NONPACKET-MODE 

DTE 

(START-STOP TERMINAL) 



X.28 DEFINES 
THIS LINK 



Figure 2 X»3, X»2S, and X.29 Protocols 



Notes on Figure 2 

1. X.3 — Packet Assembly/Disassembly (PAD) facility in a 
public data network. 

2. X.28 — DTE/DCE interface for start-stop mode DTE 
accessing the PAD facility in a public data network 
situated in the same country. 



3. X.29 — Procedures for the exchange of control information 
and user data between a packet-mode DTE and a PAD 
facility. 
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X.25 Levels 



The X.25 specification consists of three levels: 

• Level 1 — Hardware characteristics for the DTE/DCE 
interface (X.21-bis or RS-232-C) . 

- Defines physical characteristics 

Defines electrical characteristics 



Defines operational function of 
circuits 



the interchange 



Defines fault indications 

• Level 2 — Data Link Control procedure for the DTE/DCE 
interface Higher Level Data Link Control (HDLC) . (Refer to 
Appendix A for details.) 

- Frame structure 

Error detection and retransmission 
Link level flow control 

• Level 3 — Packet procedure across the DTE/DCE interface 
(X.25). (Refer to Appendix B for details.) 

Packet structure 

Virtual call establishment and clearing 

Virtual circuit flow control 

Error detection and recovery 



USER LEVEL 


DATA 












PACKET (LEVEL 3) 


PACKET 
HEADER 


DATA 












FRAME 
(LEVEL 2) 


FLAG 


FRAME 
HEADER 


INFO FIELD 


FCS 


FLAG 



Figure 3 Protocol Layering in X.25 
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Virtual Circuits 

The concept of the virtual circuit is necessary in 
understanding X.25. When a computer is to be added to the PPSN, 
it is given a unique DTE address. It is also given a range of 
logical channel numbers. 

When a program on a local DTE wants to communicate with 

another program on a remote DTE, it requests the use of a free 

logical channel number. A CALL REQUEST packet is sent from the 
local DTE. 

> 
If the call is accepted by the remote program, a CALL ACCEPTED 

packet is sent. The packet contains a free logical channel number 

from the remote DTE. The numeric valrue of the logical channel 

number from the local DTE may be different from that of the remote 

DTE. 

A virtual circuit now exists and data exchange may proceed. 
The packets sent on this virtual circuit contain the logical 
channel number between the local DTE and DCE. The packets arrive 
at the remote DTE with the logical channel number between the 
remote DCE and DTE. 
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Figure 4 Virtual Circuits and Logical Channel Numbers 
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Other X.2S Facilities 

• Other facilities provided by the Public Packet Switched 
Systems normally includes 

- Permanent virtual circuits — No setting up sequence 
required 

- Flow control (by using window size) to increase 
throughput and reduce the change of congestion. (Refer 
to Appendix B for further details.) 

Interrupts — One byte of user-defined data 

- Resets and restarts — Reinitialize one or all circuits 

• Other optional features may include: 

- Closed user group 
Reverse charge 
Incoming call redirection 
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APPENDIX A 
Data Link Control Protocol 



Objectives of HDLC 



• To protect data transmission from errors. 

• The data field can be any number of bits and any pattern of 
bits. 

• The protocol should be able to handle point-to-point, 
multipoint, or looped physical links (not necessarily true 
on X. 25 subnets) . 

• The protocol should be able to handle half- or full-duplex 
links . 

• The protocol should be as efficient as possible. 

Frame Structure 



FLAG 
01111110 



ADDRESS 
8 BITS 



CONTROL 
8 BITS 



-ff- 



INFORMATION 
(VARIABLE) 

•/ 



FRAME CHECK 
16 BITS 



FLAG 
01111110 



Figure 5 HDLC Frame Structure 

Notes on Figure 5 

1. Flag — Used to denote the start/ end of data. 

2. Address — Used by the primary station to address the 
secondaries and by the secondary to identify their 
responses. 

3. Control — Identifies the frame as Informational (I), 
Supervisory (S), or Unnumbered (U) . 

4. Information — The data to be transmitted. 
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Frame Format 

• Informational frame (I) — An I frame is used to transmit 
data and may also acknowledge previous correctly received I 
frames. 

• Supervisory frame (S) — An S frame is used to perform 
channel control functions such as acknowledging correctly 
received I frames, requesting retransmission of I frames, 
or indicating temporary unavailability for receiving I 
frames. 

There are three supervisory frames: 



RR — Receive Ready 

- RNR — Receive Not Ready 

- RE J — Reject 

• Unnumbered frame (U) — A U frame is used to 
additional link control functions. Normal 
operations use only I frames and S frames. Some U 
are: 



provide 

routine 

frames 



SABM — Set Asynchronous Balanced Mode 
SARM — Set Asynchronous Response Mode 
UA — Unnumbered Acknowledgment 
DM — Disconnect Mode (LAPB only) 
DISC — Disconnect 
CMDR — Command Reject (LAP only) 
FRMR — Frame Reject (LAPB only) 



(LAPB only) 
(LAP only) 



NOTE 
RSX PSI, Version 2.0 supports only LAPB. 
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(SENT LAST)' 



(SENT FIRST) 



INFORMATION FRAME 
SUPERVISORY FRAME 
UNNUMBERED FRAME 



1 2 


3 


4 5 


6 


7 


NR 


P/F 


NS 





NR 


P/F 


* 


1 


** 


P/F 


»* 


1 1 



POLL/FINAL BIT 



* = CODES FOR SUPERVISORY COMMANDS/RESPONSES 
** = CODES FOR UNNUMBERED COMMANDS/RESPONSES 



Figure 6 Control Field Formats 



Example of Data Exchange 



i (NS=ONR=0) 



S(RR) (NR=1! 



(NS=1 NR=0) 



(NS=0NR=2) 



(NS=2NR=1) 
(NS=3 NR=1) 
(NS=4NR=1) 



I (NS=1 NR=5) 



S(RR)(NR=2) 



MKV84-0904 



Figure 7 Data Exchange Using the HDLC Protocol 
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Link Control Procedure 

Two sets of procedures for link control are defined in the 
X. 25 recommendation as follows: 

• LAP — The DTE/DCE interface is defined as operating in 
two-way simultaneous Asynchronous Response Mode (ARM) . 
That is, both DTE and DCE perform primary and secondary 
functions, 

• LAPB — The DTE/DCE interface is defined as operating in 
two-way Asynchronous Balanced Mode (ABM) . This is 
described in detail. 

Using the concept of a finite-state machine, the DTE/DCE link 
can be in one of the following states: 

• LINK UP — The link setup procedure has been completed and 
link is in the information transfer state. 

• LINK DOWN — The link is operational but waiting for the 
link setup procedure to be initiated by the DCE. 

• LINK FAILURE — The link is considered dead by either the 
DCE or the DTE, and the link disconnection procedure has 
not been completed. 
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In addition, the DTE/DCE link can be in one of the following 
transient states: 

<y Jjn* JL 1^1 XV Vft £j __ ^J __r A XX %_? *—* A I^j £X Qi >^ > A X X A ■ t A <Ct L» t_S CJ cf _* ^s? v-J ^§ ^5 _^ k= A, ^? A 23 15 V- v* A I, 1^1 

up the link. 

• LINK DISCONNECT — Either the DTE or the DCE has initiated 
a request for disconnecting the link. 

• LINK RESET — The DTE or the DCE has initiated a request 
for resetting the line. 

Link Synchronization 

The Flag (01111110) is also used for synchronization. To 
synchronize a channel, the receiver searches for the unique flag 
pattern (01111110) . 

Recognizing Data Size 

• The flag byte 01111110 is used. 

• Every message begins and ends with a flag byte. 



SO una u liic iiay uyte pattern Can Hcvci Gv*~i;Ul u'y uiiau<_6 



• A zero bit is inserted after every five 1-bits in the data 

-. _ ..1_._.l- 1_ _ _. _"!__, 1_--J__ __.l_.l_ 

ou una u uuc _xay uytc patu 

• Example of this technique: 



Transmitted Pattern Received Pattern 

Original Pattern with Zeroes Inserted with Zeros Removed 

101010101010 101010101010 101010101010 

111111111111 11110111111011 11111811111811 

0111110 0111100 01111180 

01111110 01111010 011111810 
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APPENDIX B 
X.25 Level 3 Packet Procedure 



Genera! 



• Level 3 defines the packet level procedure. This procedure 
enables DTEs to communicate with one another across the 
network. 

• The maximum size of a packet is determined by the PPSN 
(usually 128 bytes) . 

• The general procedure for a switched virtual circuit may be 
treated in three parts: 

- Setting up a virtual circuit 
Exchanging data 

- Clearing a virtual circuit 

• Note that the format of the data exchanged within a virtual 
circuit is not specified within X.25. The data may contain 
any other user-defined protocol plus any user data. For 
example, between two DIGITAL systems, the NSP protocol may 
be used. 



Packet Structure and Types 

The general format is shown in Figure 8 
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BIT NO. 



8765 



4321 



OCTET 1 



OCTET 2 



OCTET 3 



OCTET 4 



OCTET 131 



GFI 


LCGN 


LCN 


PTI 


INF 


DATA 



Figure 8 General Packet Format for the X. 25 Level 3 Protocol 

Notes on Figure 8 

1. GFI (General Format Identifier) — A four-bit binary-coded 
field that identifies the general type of packet group. 

2. LCGN (Logical Channel Group Number) — Depending upon the 
PPSN, LCGN may identify a particular DTE, a customer, or 
class of service. The LCGN is zero in RESTART, RESTART 
CONFIRMATION, and DIAGNOSTIC packets. 

3. LCN (Logical Channel Number) — This identifies the 
logical channel. The LCN appears in every packet except 
restart packets. LCN is zero in RESTART, RESTART 
CONFIRMATION, and DIAGNOSTIC packets. 

4. PTI (Packet Type Identifier) — This defines the packet 
type . 

5. INF (General Information) — This contains information 
such as the DTE addressed, and clearing, resetting, and 
restarting causes. There is no information field in data 
packets. 

6. DATA — This contains user data (data packets only) . 
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Table 1 X. 25 Packet Types 





Packet Type 


PTI 


From DCE to DTE 


From DTE to DCE 


87654321 


Call Setup and Clearing 



Incoming Call 
Call Connected 
Clear Indication 
DCE Clear Confirmation 



Call Request 00001011 

Call Accepted 00001111 

Clear Request 00010011 

DTE Clear Confirmation 00010111 



Data and Interrupt 



DCE Data 

DCE Interrupt 

DCE INT Confirmation 



DTE Data 

DTE Interrupt 

DTE INT Confirmation 



XXXXXXX0 

00100011 
00100111 



Datagram* 



DCE Datagram 

Datagram Service Signal 



DTE Datagram 



XXXXXXX0 
XXXXXXX0 



Flow Control and Reset 



DCE RR (Mod. 8) 
DCE RNR (Mod, 8) 

DCE RR (Mod. 128)* 
DCE RNR (Mod. 128)* 

Reset Indication 

DCE Reset Confirmation 



DTE RR (Mod. 8) XXX00001 

T^miri i-»»ri-i #m»_ j o\ \rwnm /a i 

ULCt TKViZK \1-VJU. , Of AAABDJ.BJ. 

DTE RE J (Mod. 8)* XXX01001 

DTE RR (Mod. 128* 00000001 

DTE RNR (Mod. 128)* 00000101 

DTE REJ (Mod. 128)* 00001001 

Reset Request 00011011 

DTE Reset Confirmation 00011111 



Restart 



Restart Indication 

DCE Restart Confirmation 



Restart Request 11111011 

DTE Restart Confirmation 11111111 



Diagnostic 



Diagnostic* 



11110001 



X - Indicates that the bit may be set to either or 1. 

* - Indicates that this packet is not necessarily available on every 
network. 
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Message Exchange 



LOCAL DTE/DCE INTERFACE NETWORK REMOTE DTE/DCE INTERFACE 



DTE DCE 



DCE 



DTE 



REQUEST 












INCOMING 
CALL 


». 






<+ 


CALL 
ACCEPTED 


DATA 


CALL 
CONNECTED 

► 








M 
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► 

DATA 


•4 

DATA 


► 












». 






«« 


DATA 


■# 








CLEAR 

REQUEST 


^ 










Pi car 






INDICATION 


-CLEAR 

CONFIRMATION 
















TK-945 7 



Figure 9 A Typical Call Sequence 



20 



DECnet-RSX PACKETNET SYSTEM INTERFACE 

Flow Control 

• Flow control for control packets: 

- Control packets are defined in pairs (for example, Call 
Request and Call Connected packets; Clear Request and 
Clear Confirmation packets) . 

- After a DTE sends a Call Request packet, it can do 
received a Call Connected or a Clear Request packet. 

^"* * La 1 oS in ^J ^ XI O Q t? ^? la w L ^? -L 3 X» £i t* i JL ^? tw ^? JL t=/£3 Vs» Iv fc? t &3 U j lA ^J w 

allowing any further packets to be sent on a particular 
virtual circuit until the previous action is 
acknowledged or completed. 

• Flow control for data packets; 

Each data packet is sequentially numbered in either 
module 8 or module 128 as specified by the PPSN. 

- Concept of window is used. The window size can be from 
1 to 7 or from 1 to 127. Only data packets with a 
number within the window can be sent. 
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PACKETS THAT CAN BE 
TRANSMITTED ARE 2, 3, 4, 5 



Figure 10 Window Operations 



Notes on Figure 10 

1. The window size = 4. 

2. The last receive sequence number is 2. Hence the lower 
window size is 2 and the upper window size is 6 (2 + 4). 
The packets that can be sent are 2, 3, 4, and 5. 



3. 
4. 



5. 



If no acknowledgment is received, the window cannot be 
turned and no more messages can go out. 

If an acknowledgment containing 4 as the receive sequence 
number is received while packets 2, 3, 4, and 5 are sent, 
a window turn takes place. The lower window size becomes 
4 and the upper window size becomes (4 + 4 Module 8). 



Packets 4, 5, 6, and 7 are within the window and 
sent. 



can be 
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EXERCISES 



Is Match ths following PPSN names to the appropriate countries* 

a. PSS : 1. United States 

b. TELENET __ 2. West Germany 

c. DATAPAC __ 3. United Kingdom 

d. TYMNET 4. Holland 

e. TRANS PAC ___ 5. France 

f. DATEX-P , 6. Italy 

7. Canada 

2. Select the best answer for each. 

1. The X. 25 recommendation defines the: 

a. Interface between the two DTEs 

b. Interface between the two DCEs 

c. Routing algorithm in the PPSN 

d. None of the above 

2. The term PAD stands for: 

a. Packet Assembler Device 

b. Principle Address of Destination 

c. Packet Assembler/Disassembler 

d. Primary Access Device 
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3. The X. 29 recommendation defines the: 

a. Interface between a terminal and DTE 

b. Interface between a DCE and DTE 

c. Interface between a DTE and a modem 

d. None of the above 

4. Level 2 of the X. 25 protocol: 
\ a. Defines the Data Link 

b. Defines the Virtual Circuit 

c. Defines the Logical Link 

d . b and c 

5. Level 3 of X. 25 provides: 

a. Data integrity over the Logical Link 

b. Flow control over the Virtual Circuit 

c. Defines the permanent Virtual Circuit 

d. Defines the hardware interface 
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SOLUTIONS 

1. Match the following ppsn names to the appropriate countries 

a. PSS 3 1. United States 

b. TELENET 1 2. West Germany 

d. TYMNET 1 4. Holland 

e. TRANS PAC 5 5. France 

f. DATEX-P 2 6. Italy 

7. Canada 

2. Select the best answer for each. 

1. The X. 25 recommendation defines the: 

a. Interface between the two DTEs 

b. Interface between the two DCEs 

c. Routing algorithm in the PPSN 
'dJ None of the above 



2. The term PAD stands for: 

a. Packet Assembler Device 

b. Principle Address of Destination 
- Q Packet Assembler/Disassembler 

d. Primary Access Device 



.25 



DECnet-RSX PACKETNET SYSTEM INTERFACE 



3. The X. 29 recommendation defines the: 

- (&\ Interface between a terminal and DTE 

b. Interface between a DCE and DTE 

c. Interface between a DTE and a modem 

d. None of the above 

4. Level 2 of the X. 25 protocol: 
(a\ Defines the Data Link 

b. Defines the Virtual Circuit 

c. Defines the Logical Link 

d . b and c 

5.. Level 3 of X. 25 provides: 

a. Data integrity over the Logical Link 
(bj) Flow control over the Virtual Circuit 

c. Defines the permanent Virtual Circuit 

d. Defines the hardware interface 
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DECnet-RSX INSTALLATION AND CHECKOUT 



INTRODUCTION 

Before the DECnet-RSX software can run on the RSX-11 system, 
the following must be performed: 

• SYSGEN — For including DECnet-RSX related considerations 
such as assigning the partition for the Communications 
Executive (CEX) , increasing the available vector area to 
allow for the communications hardware to be installed, 
including certain features for a terminal driver, and so 
on. 

• PREGEN — For copying the DECnet-RSX distribution to the 
disk media from which from which the actual NETGEN occurs. 

• NETGEN — For generating the DECnet-RSX software. 

• NETINS — For bringing up the DECnet-RSX software. 

• NTEST — For testing the DECnet-RSX software. 
This module covers these procedures in detail. 



OBJECTIVES 

To install the DECnet-RSX software, the specialist must be 
able to: 

List the SYSGEN requirements for DECnet-RSX. 

List the DECnet and PS I major components. 

Identify the features of the major components. 

Perform the NETGEN procedure. 

Perform the NTEST procedure. 

RESOURCES 

1. DECnet-RSX Network Generation and Installation Guide 

2. DECnet-RSX System Managers Guide 
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DECnet-RSX INSTALLATION AND CHECKOUT 

COMPONENTS 

There are three categories of components: 

• NET components support the Communications Executive and 
provide for general communications functions. These 
components include: 

- NET Communications Executive components 

NET Communications Executive support components 

- NET System Management utilities v 

• DEC components are specific to DECnet. They include: 

- DECnet communication components 

DECnet Network Management support components 
DECnet satellite support 

- DECnet file utilities 

DECnet network terminal and control utilities 

• PSI (Packetnet System Interface) components allow DECnet 
to communicate with a Public Packet Switching Network 
(PPSN) using the X. 25 protocol. These components include: 

- Required PSI communications components 

Optional PSI components 

PSI components are included in your system only if you 
have purchased a license for the PSI product. 

Table 1 is a list of individual components. The table shows 
whether the component is required (R), always built but not 
absolutely required (A), optional (0), or never used (N ) for your 
RSX-11M, M-PLUS, or (S) system. In very small systems, you may 
choose not to install tasks marked "A" as a way of saving memory. 

The table provides a reference to the section where the 
dialogue for a given component is presented. The tab!>e~also tells 
whether a component is a task or a process. Note that the 
Communication Executive is neither a task or a process, but .is 
rather an extension of the RSX executive. 
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Table 1 DECnet Components 



Task 


System 




or 








Process 


M 


M + 


S 


— 


R 


R 


R 


P 


R 


R 


R 


P 


R 


R 


R 



Notes 



CEX Communications Executive 

AUX Auxiliary Process 

DDM Device Driver Modules 



NET Communications Executive Support Components 

NTINIT Network Initializer 

NTL Network Loader 

KMCL KMC Microcode Loader 

MLD General Microcode Loader 

EVL/EVC Network Event Logger 

DLX Direct Line Access 
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R 
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R 
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R 
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P&T 













P 











■3 

J 



NET System Management Utilities 

NCP Network Control Program 

NMDRV Network Management Device Driver 

NMVACP Network Management Volatile ACP 

CFE Configuration File Editor 

NDA Network Crash Dump Analyzer 

VNP Virtual Network Processor 



R 


R 


R 


R 


R 


A 


R 


R 


N 
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DECnet Communications Components 



ECL Network Services and Process Driver 

XPT Transport Task 

NETACP Network ACP 

Digital Communication Process 

Ethernet Protocol Manager 
NETFOR.OLB DECnet Library for Higher Level 

Languages 
NETLIB.MLB MACRO-11 MACRO Definition Library 



DCP^ 
EPM 
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Table 1 DBCnet Components (Cont) 



Task System 

or 

Process M M+ S Notes 



DECnet Network Management Support Components 

NICE Network Information and Control 

Exchange 

EVR Event Logging Receiver 

NTD Network Display Utility 

NTDEMO Network Display Server 

LIN Link Watcher 

LOO Loopback Tester 

MIR Loopback Mirror 

RCP Routing Control Processor 

NVP Network Verification Program 
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DECnet Satellite Support Components 

DLL Down-Line System Loader 

DUM Up-Line System Dumper 

CCR Console Carrier Requester 

HLD Host Task Loader 

SLD Satellite Task Loader 
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DECnet File Utilities 

NFT Network File Transfer Utility T ON 

FTS File Transfer Spooler T N 

FAL File Access Listener T 

MCM Command-File/Batch-File Submission 

Task T N 



DECnet Network Terminal and Control Utilities 



Terminal Utility RMTACP 

and 



RMT/RMTACP 

Remote 
RMHACP/HTDRV 

Remote Terminal Host ACP 

Host Driver 
NCT Network Control Terminal Task 

TLK Interterminal Message Utility 

LSN TLK Server Task 

TCL Remote Task Control Utility 
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Notes 



1. KMCL is required for all 11M/11M-PLUS systems if you 
specify KMC or KMS devices and specify powerfail recovery 
support. KMCL is required on IIS systems that support KMC 
or KMS devices. 

2. MLD is required for all systems if you specify Ethernet 
devices. 

3. DLX is required if you specify certain operations (see 
Section 2.4.1.5 in the DECnet-RSX Network Generation and 
Installation Guide for more information) . 

4. NMDRV is always built only if EVL is specified. 

5. DCP is required for all systems if you specify devices 
that require software DDCMP support. 

6. EPM is required for all systems if you specify Ethernet 
devices. 

7. RCP is required only for routing type nodes. 
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Tasks and Processes 

There are two types of components: tasks and processes. 
Tasks are the normal tasks on RSX (for example, ready-to-run core 
images that are scheduled to run by the RSX Executive) . Processes 
are special units of code that are scheduled and run by the 
Communications Executive. The Communications Executive is an 
extension of the RSX Executive and performs special services for 
communications products such as DECnet. Processes are largely 
invisible to the RSX Executive; they are totally self-contained 
within DECnet. Processes are core-resident, are no more than 4K 
in size, and perform time-critical DECnet functions. 

In several cases, individual processes are paired with 
associated tasks that are larger and assist with less 
time-critical functions. These tasks are called Ancillary Control 
Processors (ACPs) . For example, NSDRV, which is the process that 
creates and maintains logical links, has an associated ACP, 
NETACP, which assists it with its less time-critical processing. 
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HOST SYSTEM CONFIGURATION 

To run NETGEN, the host system must be either RSX-11M, Version 
4.1 or RSX-I1M-PLUS, Version 2.1. 

The host must have a minimum amount of available disk space. 
In addition to the disk used for the operating system, 1 RL01/02 
satisfies this minimum. With larger-capacity disks, fewer drives 
are required. With an RM02/03, RM05, RM80, RP06 or RP07 disk one 
disk is usually sufficient to store the operating system and all 
the files necessary to perform NETGEN. 



TARGET SYSTEM CONFIGURATION 

The target system must be either RSX-11M, Version 4.1; 
R3X-11M-PLUS, Version 2.1; or RSX-11S, Version 4.1. 

The target system must be a mapped system with a minimum of 
16K words of memory dedicated to the DECnet software. Additional 
memory is required for user-written network tasks and any DECnet 
utilities. 

The target system must have at least one communications device 
to satisfy the minimum hardware requirements. 
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DEVICES SUPPORTED BY DECnet 

The following devices are supported by DECnet: 

Table 2 Device Support for RSX-DECnet PS I 

UNIBUS Devices Q-Bus Devices 

Asynchronous Line Support 

DL-11 DLV-11 

DZ-11 DZV-11 

KMC-ll/DZ-11 

Synchronous Line Support 

DMP-11 DMV-11 

DUP-11 DPV-11 

DU-11 DUV-11 

■DMC-11 
DMR-11 
DV-11 
KMC-ll/DUP-11 

Parallel Line Support 
PCL-11 

Ethernet Line Support 

DEUNA DEQNA 

Supported for PS I 

DUP-11 DPV-11 

KMS-11 
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PREPARING FOR NETGEN 

The logical procedure for creating a DECnet node (for RSX-11M 
systems only) consists of these steps: 

1. Performing SYS GEN 

2. Defining partitions (by editing SYSVMR.CMD) r*/^ 

3. Performing PREGEN 

4. Performing NETGEN 

5. Using NETINS.CMD to install components in the correct 
partitions (see Chapter 8 of the DECnet-RSX Generation 
and Installation Guide ) . 

System Sizes 

The way you configure your network depends on your system's 
memory size. For the purposes of NETGEN, your system can be 
classified into small, medium, and large, defined as follows: 

Small = Under 80K words of memory 

Medium — 80K to 124K words of rneinory 

Large = Over 124K words of memory 



NOTE 
These definitions are based on light network 
loading and are somewhat arbitrary. 

Available memory is most important, and this 
is altered both by the specific complement of 
network components you select and by your 
other software and application programs. 



These definitions of small, medium, and large systems should 
serve only as a guide. To get a more accurate system capacity, 
you need to determine the amount of available memory in GEN after 
the basic network and your application are running. (See Section 
3.1.6 of the DECnet-RSX Generation and Installation Guide for more 
information. ) 



10 



DECnet-RSX INSTALLATION AND CHECKOUT 



RSX-11M Systems 



For RSX-11M systems, the partition layout you select varies 
depending upon the size of your system and your intended uses. In 
all cases, you must add the partition CEXPAR. 



RSX-11S Systems 

Because RSX-11S systems are often special-purpose 
systems, it is difficult to make any specific 
determining partition layout. You need to add the 
CEXPAR. 



dedicated 

rules for 

partition 



HIGH 



GEN 




FCPPAR (OPTIONAL) 




SYSPAR 




DRVPAR (OPTIONAL) 




TTPAR (OPTIONAL) 




LDRPAR (OPTIONAL) 




-1fi OR ?f)K 


CEXPAR 


*> 

> 


EXECUTIVE 
> ADDRESS 
SPACE 


DSR POOL 


EXECUTIVE 






TK-9464 



Figure 1 Partition Layout after SYSGEN 
(With CEXPAR Added) for RSX-11M/S 
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RSX-11M-PLUS 

For RSX-11M-PLUS systems, no special partitions are necessary 



crcy 



COMM-EXEC 
CODE 



11M-PLUS 
EXEC 



CEXBF 



20000 



POOL 
SPACE 



11M-PLUS 

EXECUTIVE 
DATA 



COMM-EXEC 
DATA 



NETCM 



I - SPACE 



D - SPACE 



TK-4803 



Figure 2 RSX-11M-PLUS Communications Executive Implementation 
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Small RSX-11M Systems 

For small RSX-11M systems, 
Figure 3 is recommended. 



the partition layout shown in 



OTHER 
CEXPAR PARTITIONS FCPPAR 



GEN 



EXECUTIVE 


POOL 


CEX 


— — — — 


F11ACP 
NETACP 
NMVACP 
NTINIT 


ALL OTHER 
TASKS 



16K 
(TYPICAL) 



TK-9461 



Figure 3 Partition Layout for Small RSX-11M Systems 



Here, NETACP, NMVACP, and NTINIT are installed in FCPPAR, 
where they run along with F11ACP, the Files-11 ACP. NETACP must 
be generated as checkpointable. You should size FCPPAR to 
accommodate the largest task in the partition; this often is 
NETACP. You can arbitrarily choose a size for FCPPAR that is too 
large (7K words) and then reduce the size appropriately after 
NETGEN, when you know the actual sizes. All other network and 
user tasks are installed in GEN. Jf> ,,-- 
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Medium-Sized RSX-11M Systems 

For medium size RSX-11M 
Figure 4 is recommended. 



systems, the partition layout in 



OTHER 
CEXPAR PARTITIONS FCPPAR ACPPAR 



GEN 



EXECUTIVE 


POOL 


CEX 


—_»_—— __ 


F11ACP 

NMVACP 

NTINIT 


NETACP 


ALL OTHER 
TASKS 



TK-9462 



Figure 4 Partition Layout for Medium-Sized RSX-11M Systems 



Here, NETACP has been removed from the 
placed in its own partition. 



FCPPAR partition and 



The advantage of removing NETACP from the FCPPAR partition in 
this way is that both NETACP and F11ACP are very active tasks, and 
this layout avoids needlessly swapping them in and out of memory. 
The result is increased performance. This layout has all the 
other advantages of the recommended layout for small RSX-11M 
systems. 
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Large RSX-1 1 M Systems 

Figure 5 assumes that you decided to put F11ACP (the FILES-11 
ACP) in its own partition, FCPPAR. This is the default during 
SYSGEN. All DECnet tasks run in the system-controlled partition 
GEN. 



OTHER 
CEXPAR PARTITIONS FCPPAR 



GEN 



EXECUTIVE 


POOL 


CEX 





F11ACP 


ALL TASKS 



TK-9443 



Figure 5 Typical' Partition Layout 



15 



DECnet-RSX INSTALLATION AND CHECKOUT 

SYSGEN 

• SYSGEN support for DECnet 

e RSX and DECnet communications devices 

• Standard function system (RSX-11M/S only) 

• System controlled partitions (RSX-11M/S only) 

• SYSGEN component parameters 

• Large or Small Executive (RSX-11M/S only) 

• Editing SYSVMR.CMD (RSX-11M/S only) 

• Adding CEXPAR (RSX-11M/S only) 

• Adding other partitions (RSX-11M/S only) 
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SYSGEN Support for DECnet 

To create the proper support for DECnet on the system you are 
generating, answer YES to the following questions in the Executive 
Options section of SYSGEN: 

For RSX-11M/S Systems: 

>* 32. Include support for communications products? [Y/N]: 

For RSX-11M-PLUS Systems: 

>* CE120 Do you want support for communications products 

>* (such as DECnet)? [Y/N D:N]: 

In both cases, answering YES causes all of the essential 
DECnet support features to be added to the RSX operating system 
being generated. 
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DECnet Communications Devices 

Because the RSX-11M/S/M-PLUS Executive does not need to know 
about hardware that will be used as DECnet communications devices, 
and because no communications device can be shared between DECnet 
and the Executive, do not specify any DECnet communications 
devices when answering questions in the Target Configuration 
section of SYSGEN. However, when you generate your RSX system, 
you must specify how much space is to be allocated for interrupt 
vectors on your target system. The space must be sufficient to 
include the interrupt vectors belonging to DECnet devices. To 
specify properly, answer the following question with the highest 
vector address of any devices on your system, including the DECnet 
communications hardware. 

For RSX-11M/S Systems: 

>* 14. Higest interrupt vector: 

For RSX-11M-PLUS Systems: 

>* CP9632 What is the highest interrupt vector address? 

These vector addresses are available as a result of hardware 
installation. 

For this question- do not specify the default? since the value 
that SYSGEN computes in this case would not take into account 
DECnet communication devices. For example on RSX-11M and RSX-11S 
systems, increase the value by octal 20 if your DECnet system 
includes any of the following character interrupt devices: DL, 
DLV, DPV, DU, DUP, DUV. This is necessary because, for these 
devices, the transmitter section of the device driver may 
interrupt the receiver interrupt handler. When such an interrupt 
occurs, the interrupted values are stored on the kernel stack. 
The extra 20 bytes make room for these values.- For RSX-11M-PLUS 
systems, 20 bytes are added automatically. 

In answering this question for your operating system, leave 
enough space for devices you have or will have soon, as the 
Executive is built above the address you supply, and overwrites 
any vectors in its space. For all systems, answering 774 
guarantees that the value is sufficiently high, but usually 
results in some loss of available memory (memory that would 
otherwise be used as system pool). 
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Standard Function System (RSX-11M Only) 

For RSX-11M systems, Question 9 at the beginning of SYSGEN 
asks : 

>* 9. Do you want a Standard Function System ? [Y/N]: 

If you answer the question YES and select the standard 
function system, you automatically receive the following options 
(others may be included) : 

• System-controlled partitions 

• Checkpointing (but without the system checkpointing file) 

• Full-duplex terminal driver (with all options) 

• Large (20K) Executive 

--..._ __.__„ Fnote \ _„. „ ... 

If you choose the stand ard^~~funcl:ioh system, 

; you are not able to dynamically change your 

\ maximum node address, since the standard 

\ function system does not support the required 

system checkpointing, file. 



^ 



v c? L 
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Pre-SYSGENed System (RSX-11M-PLUS Only) 



If you choose the pre-SYSGENed system available for 
RSX-11M-PLUS systems, you must edit one symbol found in the 
RSXMC.MAC file on UIC [11,10]. This is because the target 

oT7~~""R$$TPR; Is" not properly set up to define the 

type of your ^^^.gg^ system. Using an editor, 
symbol in the file. Edit this symbol to read: 



processor 
real processor 
search for the 



R$$TPR="nn 



Where nn equals the number of the processor, such as 44 for a 
PDP-11/44. This change is required prior to NETGEN; no 

rebuilding of the operating system is required. 

System-Controlled Partitions (RSX-11M/S Only) o , 

As a general rule, you should request system-controlled 
partitions for RSX-11M/S systems. This is specified in Question 
33 of the Executive Options section of SYSGEN: 

>* 33. system controlled partitions? [Y/N]: 



tasks to be 






System-controlled partitions allow most network 

;«4-^v s-tmA r>a w 4- 4 4- { ** >* /rMT\T\ ?>«x3 -,.■■+- ^m ■» 4- ■? /-• al 1 t» 

nibu uii^ ^/u i. k.x v. xvi: \ u u i' / , uitu <_«i_i<_vyiu<-*v_-i.\_cjj.j.jr 

out of memory. The only situation where you might not want to use 
system-controlled partitions is in a dedicated system in which one 
task is loaded into each partition, thus ensuring that the task is 
always in memory. Each such partition should be sized exactly for 
the particular task. Such a system would save the small amount of 
memory used by the Executive to handle system-controlled 
partitions. 



20 



DECnet-RSX INSTALLATION AND CHECKOUT 



SYSGEN Component Parameters 

The following parameters that you specify in SYSGEN do not 
affect the overall performance of DECnet, but only that of 
specific DECnet components. 

Changing Number of Nodes (RSX-11M Only) 

If you want to be able to change the number of nodes in your 
network without rebuilding the Routing Control Processor (RCP) 
task, select dynamic checkpoint allocation support. Question 49 
in the Executive Options section of SYSGEN asks: 

>* 49. Checkpointing: A-Yes B-With system ckpnt. file [S]: 

Answering B enables dynamic checkpoint support. (You should 
always select checkpointing in some form, that is, either A or B.) 

Support for TLK (RSX-11M/S Only) 

Question 1 of the Terminal Driver Options section of SYSGEN 
asks : 

>* 1. Terminal driver desired (A/B/C/D, * prints table) [S]: 

If you enter an asterisk (*), SYSGEN prints the following table: 

Terminal drivers: 

A. - Tailorable half-duplex \~ t 

! B. - Tailorable half-duplex (user oriented) 

\C. - Full-duplex ^,- I 

D. - Baseline half-duplex 

Answering A, B, or C produces satisfactory results. Answering 
B automatically provides the necessary support for both versions 
of TLK. If you. answer A or C, you must select the specific driver 
features desired. 

If you want either mode of TLK (dialogue mode or 
single-message mode), you must answer YES to the following 
question: 

>* 8. Breakthrough write? [Y/N]: 



21 



DECnet-RSX INSTALLATION AND CHECKOUT 



If you want the dialogue mode of TLK, you must answer YES to 
the following question: 

> 17. Read after prompt? [Y/N]: 

If you want the video dialogue mode to TLK, and if you 
answered A or C to Question 1, you must answer YES to the 
following question in the same section of SYSGEN: 

>* 6. Unsolicited input character AST? [Y/N]: 

Asynchronous System Traps (ASTs) are software interrupts. 
Answering YES to this question allows your terminal to process 
characters typed on the keyboard at the same time characters are 
being printed on the screen. Support for unsolicited input 
character ASTs is automatically included if you answer B to 
question 1. For more information on TLK, see the 

DECnet-RSX Guide to User Utilities . 

Support for PSI X.29 (RSX-11M Only) 

If you want support for PSI, you must answer C to the terminal 
driver question (Question 1) under Support for TLK. PSI's X29ACP 
requires the full-duplex driver. 

Also answer YES to Question 12: 

>* 12. Set multiple characteristics? [Y/N]: 

The result is to create MCR support for SET commands relating 
to terminals, such as: 

SET /VT100=TI: 
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Queued File Access Requests 

FTS allows file access requests (file transfers, and so on) to 
be queued and processed in sequence. If you want FTS, the 
RSX-11M/M-PLUS Queue Manager (QMG) must be built during SYSGEN. 

For RSX-11M systems, the following question in the Executive 
Options section of SYSGEN must be answered YES. 

-r ^^. ,-v4> - >* 35. Queue manager and queued print spoolers? [Y/N]: 

f ^ % '* ■*?/ 

For RSX-11M-PLUS systems, answer YES to the following 
/questions : 

/ >* CE180 Do you want to include the Queue Manager? [Y/N D:N]: 

(For more information on FTS, see the DECnet-RSX Guide 
V to User Utilities.) 
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Large or Small Executive (RSX-11M/S Only) 

The RSX Executive for an RSX-11M or RSX-11S system can be 
built in either 16K or 20K of address space. In the Executive 
Option section of phase 1, SYSGEN asks the following question: 

>* 22. Large (20K) Executive? [Y/N]: 

If you answer N O to this question you get Jbhe 16K ^Executive^.^ 

This question determines the amount of Executive address space 
allocated to the Executive plus DSR (pool). The size of the 
Executive itself is determined solely by your answers to questions 
about Executive options. The space left over is allocated to 
pool. This allocation, however, can be altered by editing the 
SYSVMR.CMD file. 

Deciding which size Executive to choose depends upon your type 
of system, its size, and its intended use. In general, for medium 
to large RSX-11M systems, you want the 20K Executive because the 
extra pool is useful. You have enough memory so that the 4K 
allocated to pool does not significantly affect your ability to 
run tasks. 

On small RSX-11M systems, you need to make a trade-off 
decision between the need for pool and the need for extra task 
snarp. Often vou mav decide to use the smaller Executive = 

Editing SYSVMR.CMD (RSX-11M/S Only) 

For RSX-11M and RSX-11S systems, it is necessary to add at 
least one partition, CEXPAR, to the system in order to run DECnet. 
For medium size RSX-11M systems, you may also wish to add another 
partition. These partitions are added by editing the SYSVMR.CMD 
command file. 

In Phase 2 of SYSGEN, VMR Question 1 asks: 

>* 1. Edit SYSVMR.CMD? [Y/N]: 

Answer this YES, and SYSGEN pauses and allows you to edit the 
file. You can answer NO (or press return <RET>) and edit the file 
later . 



" " : ) , 






24 



DECnet-RSX INSTALLATION AND CHECKOUT 



Adding CEXPAR (RSX-11M/S Only) 

For RSX-11M/S systems, the necessary partition (CEXPAR) is 
incorporated by adding a SET /MAIN=CEXPAR line to the SYSVMR.CMD 
file. 

The beginning of the SYSVMR.CMD file from an RSX-11M system 
looks like this: 

RSX11M 

SET /POOL=* 

SET /MAIN=EXCOM1:*:200:COM 

INS EXCOMl 

SET /MAIN=EXCOM2:*:200:COM 

INS EXC0M2 

SET /MAIN=LDRPAR:*:26:TASK 

INS LDR 

FIX LDR. .. 

SET /MAIN=TTPAR:*:400:TASK 

LOA TT: 

SET /MAIN=DRVPAR:*:*:SYS 

You should add a line to the SYSVMR.CMD file between the SET 
/POOL= command and the SET /MAIN command for the first partition 
shown. To reflect the base address at which CEXPAR loads, change 
the value of the SET /POOL= line. The effect of these changes is 
that CEXPAR loads immediately above the RSX Executive and pool. 

The format of the two lines is: 

SET /POOL =base u Mdress 

SET /MAIN=CEXPAR^size:COM 



C A, 'PA-i-' X ' 



-O ' cou 
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The asterisk (*) here means, load at the next available 

location. The word COM signifies that this is a common block 
partition. The base address, which is also the top of the pool, 

and size are shown {default values): 

Executive CEX Base Par 

(in words) Size(l) Address(2) Size(2) 

20K large 1120 60 

20K small 1140 40 

16K large 72 60 

16K small 740 60 



CEX size is determined as follows: CEX is automatically 
generated in one of two sizes by NETGEN. For a 
DECnet-only (non-DECnet-PSI) system with only one line, 
NETGEN generates a small CEX. In all other cases, NETGEN 
generates a large CEX, 

The base address and size are shown in octal bytes. Note 
that the final two digits of the address and size are 
omitted in this table, because that is the convention 
employed by VMR. Thus, an octal byte address of 112000 is 
expressed as 1120. (In NETGEN however r ymi mngt- cy press 
the last 2 digits.) 
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PREGEN 

PREGEN is a preliminary procedure you must perform before 
generating a network. It takes your required and optional 
distribution media and merges them, so they can be used by the 
NETGEN procedure. PREGEN can run for either a standard system, or 
for a small dual-disk (RL01/02) system. The same procedure is 
used for both. 

Media Used During PREGEN 

A standard PREGEN is performed for systems other than small 
dual-disk systems. A standard PREGEN can include the following 
distribution kits (disks or magnetic media): 

• Network kit 

• DEC.net kit 

• PSI kit (optional) 

Each kit contains command files and object files. The command 

files become the corresponding parts of NETGEN: NET, DEC, and PSI 

(optional) . The object files build the appropriate NET, DEC, or 
PSI components. 

Thus, from the distribution kits, PREGEN generates the 
following logical groups of files: 



Pile 

NETGEN command files 
Network object files 
DECnet object files 
PSI object files 

PREGEN Dialogue 



Contents 

Command files from all available kits 
Object files for the NET procedure of NETGEN 
Object files for the DEC procedure of NETGEN 
Object files for the PSI procedure of NETGEN 



For distribution kits in the form of disks or tapes follow the 
procedures listed in Sections 3.3.4 through 3.3.9 of the 
DECnet-RSX Network Generation and Installation Guide. 
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NETGEN Procedures 

Network Generation consists of the following procedures: 

• NET — Communications Executive and common components 

• DEC — DECnet 

• PSI — Packetnet System Interface (optional) 

The NET procedure of NETGEN asks questions regarding the 
Communications Executive (CEX) and command components that are 
always built in the configuration of the network. The 

Communications Executive contains the general routines that 
support both DECnet and PSI. 

The DEC section of NETGEN asks DECnet specific questions. 

These questions are in addition to NET questions. NETGEN then 

builds the routines which, when combined with NET, allow the 
system to run DECnet. 

The PSI section of NETGEN asks questions regarding PSI (for 
users who have purchased a license for this product) . PSI allows 
you to access an X. 25 Public Packet Switching Network (PPSN) . 
Both DECnet and PSI can run concurrently on the same processor 
(assuming sufficient system resources such as memory) . 

NETGEN Sections 

Each procedure within NETGEN (NET, DEC, or PSI) consists of 
sections. Each section is a logical grouping of related 

questions. A section is introduced with a header such as: 

>; NET - Section 2 - Define the Target System 



This header identifies the procedure of NETGEN (NET here) , the 
section number, and provides a brief description of the purpose of 
the section. ♦ 

At the end of a section, NETGEN asks an End of Section (EOS) 
question, which gives you the option of repeating the section to 
correct any errors that may have been made in that section. 
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NETGEN Questions 

The first question in each section is numbered 01.00, the 
second 02.00, and so on. The sequence continues in this manner to 
the end of the section. Questions that have subordinate questions 
are numbered 01.01, 01.02 and so on. 

NETGEN Operating Modes 

The NETGEN procedures can be run in four operating modes: 

• Question and Answer Mode 

• Restore Mode 

• Dry Run Mode 

• Component Mode 

When you start NETGEN, you begin in Question and Answer Mode; 
you can then introduce other modes as appropriate. The other 
three modes are special cases of Question and Answer Mode. 
Restore Mode and Dry Run Mode can be invoked in any combination 
with Question and Answer Mode. Component Mode, however, is 
incompatible with either Restore Mode or Dry Run Mode. 

The modes you select remain in effect through the entire 
generation procedure. If, for example, the procedure is started 
in Component Mode, it runs in Component Mode throughout. 

User Responses and Defaults 

For the most part, your responses to NETGEN questions consist 
simply of answers to the questions. In certain cases, however, 
you may want to : 

• Use the ESCAPE key to obtain explanatory text 

• Respond to end-of-section and break questions 

• Take advantage of NETGEN defaults 
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Table 3 Summary of NETGEN Response 


Rssponse Type 


NETGEN Displays: You enter: 



Ycc /\m 



rn — m i 



rv /m i . 



V ♦•« 4 M ^{^. a 4>A VT? C XT ♦- 

indicate NO (or press 
<RET> for default NO). 



Numeric 
Octal 



Decimal 



[0 R:m-n] : 



[0 R:m-n D:d] 



[D R:m.-n.]: 



[D R:m.-n. D:d . ] 



Character 
String 



[S] 



[ff D:d] [S] 



[S R:m.-n.] 



An octal number in the 
range of m through n. 



An octal number in 
range of m through 
(or press 
cate that 



the 

n 
<RET> to indi- 
the default 



(d) should be used) . 

A decimal number in the 
range of m through n. 

A decimal number in the 
range of m through n (or 
press <RET> to indicate 
that the default (d.) 
should be used) • You do not 
need to include a decimal 
point after the number 
you enter. 

A character string of any 
length. 

A character string in the 
form f (such as ddu:), 
(or press <RET> to indicate 
that the default (d) should 
be used) . 

A character string from m 
through n characters in 
length. 
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Output from NETGEN 

Table 4 lists the disk areas where the files generated by 
NETGEN reside on the target disk. Group code x refers to the 
group code for NETGEN output that you specify in NET. The dduu: 
for Listing and Map files may represent the NL: device or any 
disk in the system. 

Table 4 Summary of NETGEN Output Files 

UIC on the Target Disk 

DECnet-llM DECnet-llS 

files 11M-PLUS 

Libraries [1,1] [1,1] 

NETHLP.ULB (Help file for NCP) [1,2] [1,2] 

Command files [x,l] [x,l] 

and work files 

NETINS.CMD 

NETCFE.CMD 

NETCFG.TXT 

Saved response files (GEN and 
RES types) 

Prefix files (used to specify [x,10] [x,10] 

conditional assembly parameters) 
NETGEN copy of RSXMC.MAC 

Object files and libraries, assembly [x,24] [x,24] 

and task build command files 

Listing files dduu: [x, 34] dduu: [x, 34] 

Map files dduu: [x, 34] dduu: [x, 34] 

Tasks' and processes [x,54] [x,64] 

CETAB.MAC 

NETGEN copy of RSX11M.STB ([x,54]) 

or RSX11S.STB ( [x,64] ) 
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NETGEN Files 

The following is a description of the NETGEN files: 

e NETINS.CMD — The Network Installation file is the file 
invoked to install DECnet. 

• NETCFE.CMD — The Network CFE Command file is an indirect 
command file used as input to CFE. This file provides a 
record of the CETAB.MAC configuration as created by NETGEN. 
It can also be used as a template for making changes to 
CETAB.MAC. In this case, you edit the file to reflect the 
appropriate changes, and then use the file as an indirect 
command file to CFE. 

• NETCFG.TXT — The Network Configuration file provides 
information in text form on the configuration of devices, 
processes, and CEX products on the target system. 

• CETAB.MAC — The Communication Executive Database file 
contains the database used to load the configuration 
defined for the node. It is one of the most important 
outputs of NETGEN. 
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GENERATION EXAMPLES 



>PIP NETGEN. CMD/LI 



Directory DR3: C137, 103 
13-DEC-83 14:02 

NETGEN. CMD51 22. 13-DEC-B3 13:29 

Total of 22. /22. blocks in 1. file 

> 
> 
> 

>8NETGEN 
>* 

> f istii3::33S3iisssss33i3»i:t3>3:<m»3a:::3»ss::S3it:sss:::::33:3:: 

>i NET - RSX-11M-PLUS CEX System Generation Procedure 
>» Started at 14:02:18 on 13-DEC-83 

> } 33S3X333333S333333333333S3333SB33333333SS33333SS33S3S2X33333333333333 

>t Copyright (C) 1981f 1982» 1983 by 

>i Digital Eauipment Corporation* haynardr Mass. 

Generate a CEX System* Version 02.00* for your RSX-11M-PLUS taraet system. 

>» The following CEX Products nay be generated 

>? OECnet 

> 

The distribution kits must be up to the current patch level. If 
necessary* you should stop the generation and apply the necessary 
patches. 

>» The logical device name LB: should already be assigned to the device 
>» which contains the library files for the system you are generating. 

These files are EXELIB.OLB* EXEMC.MLB* RSXMAC.SML* SYSLIB.OLB* and* 

for RSX-US. 11SLIB.0LB. 

The loaical device names IN:» 0U:» LS: and MPJ should not be assigned 
>» to any devices before starting the generation. These logical device 

nanes are used by NETGEN to refer to various disks used during the 
>» generation. 



>; <E0S> Do you want to: 

>* <RET>-Continuer E-Exit CSK 
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NET - Section 1 - General Initialisation 

^ j 331IXX3331f33I»»X3:333333»X3SS333S333333333S33S33333SS:s£333S:3S:: 
>» 

>* 01.00 Do sou want to see the NETGEN notes/cautions CH=N3? CY/N3: Y 
>i 

Note the following* 



If vou have not already performed a SYSGEN for your taraet system* 
sou must do so before continuing 

>i . The privileged tasks generated during NETGEN use configuration 
>i dependent parameters produced by SYSGEN. For RSX-11M/S/M-PLUS 
>» systems* the RSXMC.MAC file and the RSXUM.STB (or RSX11S.STB) file 
for the target system are necessary. If they are not already on 
the target device under the proper UIC* NETGEN will move them from 
>* the user's system device to the target device. 
>i 

>» . If your target device contains useful files* it is recommended that 
>f you back it up before continuing* as the device will be write 
enabled during the NETGEN seouence. 

The proper system libraries for the target system must be on the 
>f logical device LSI under the UIC Cl»13 while you are performing your 
>» NETGEN. These libraries are: 

EXELIB.OLB* EXEMC.MLB* RSXMSC.SML* and SYSLIB.OLB. 
In addition, for an RSX-11S NETGEN* the 11SLIB.0LB file is reauired. 

>» . If your target system supports the Queue Manager (GMG)* and you wish 

>? to generate network tasks which say use this facility? the Queue 

Manager object library must be on the logical device LB! under 

UIC Cli243 while you are performing your NETGEN. This file is: 

>i 

>» . If you wish to generate network tasks which reouire support for RMS 
file access* you must have the RMS files on your logical LB: device 
prior to performing your NETGEN. NETGEN will look for these files 
under the UIC determined by syssen. The following are the files that 

>» NETGEN will look for: 

> 

>J RMSLIB.OLB. RMS11X.0DL and RMS12X.0DL. 

>» RMSRES.TSK and RMSRES.STB (if resident libraries are supported). 

>i 

Example 1 NETGEN Dialogue (Sheet 2 of 17) 
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>» . If «our target system supports a Memory Resident or a Supervisor 

>; Mode FCS library* and you wish the network tasks to use this 

>» library* the FCS library files must be on the losical device LBi 

>» under UIC Cl»13 while you are performing your NETGEN. These files 

>» aret 
>J 

>i FCSRES.TSK and FCSRES.STB (Memory resident FCS library files). 

>i FCSFSL.TSK and FCSFSL.STB (Supervisor Mode FCS library files). 

> » 

> I . The following installed tasks are reauired on your host system while 
>» you are perf ormins your NETGEN t 

> i 

>i PIP* LBR* MAC* and TKB for RSX-11M/S/M-PLUS NETGENs. 

>i STK (slow task builder) for RSX-11M/M-PLUS NETGENs. 

>» 

>» If these tasks are not already installed* and you are logged in as 3 

>$ privileged user* NETGEN will install the* automatically. If TKB and 

>» and MAC are installed* you nay want to remove them and reinstall 

>* thee with an increment of 3000. to 15000. bytes so the build section 

>» of NETGEN will run faster. 

>» 

>» . The following installed tasks are reauired on your host system while 

>* you are performing your NETGEN* under the followina conditions! 

>» 

>» L0A and UNL if device drivers reauire loading. 

>» M0U and DM0 if disks reauire mounting. 

>» UFD if the reauired UICs do not already exist. 

>» 

>* If these tasks are not already installed* and you are logged in as a 

>» privileged user* NETGEN will install thee automatically. 

>» 

>* . If you are generating more than one network onto the same target 

>* disk* the network help file ( CI »23NETHLP .ULB) and the language 

>» libraries ( CI » 13NETF0R.0LB and CI » 13NETLIB.MLB) will be replaced 

>» each time NETGEN is run. You may want to save these files before 

>» doing the next NETGEN. This is of particular interest if one of the 

>» networks is for RSX-11S and the other network is for RSX-11M or 

>i RSX-11M-PLUS. 

>» 

>i . For Questions that can be answered YES or NO* the default is NO 

>» unless otherwise specified. For Questions with defaults* the 

>> default is produced by pressing a carriage return (<RET>) in 

>? response to the Question. 

>i 

>» . Additional explanatory text for each Question may be obtained by 

>i hitting the ESCAPE key. 

>» 

>» . Unless otherwise specified* it is possible to interrupt a series of 

>» Questions by typing <CTRL/Z>. You will then be given the options 

>» of either restarting the section from the top* temporarily stopping 

>» the generation* or terminating the generation. 

>* 

>* 02.00 Target system device Cdduu* D=SY00:3 CS3: DR3: 

>* 03.00 Listins/map device Cdduu* D»None3 CS3t 

>* 04.00 UIC Group Code for NETGEN output CO R : 1-377- D : 53 t 300 
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>» Checking for reauired librer* files* tasks* and UICs. 

>* 

>i 

>i Creating UFO for DR03. C300.00U 

>? Creating UFB for DR03. C300»0103 

>* 

>* 07,00 User 10 for savins new rts^onsn CD«None3 CS R. 0.-30. 3. 13DECRYAN 

>* 08.00 I* this generation to be a dr* run CD»N3? CY/N3. N 

>* 09.00 Oo sou want a standard function network C0*N3? CY/N3: 

>» -< 

>} Answering YES to this ouestion will result in NETGEN asking a ainiaua 

>; nuaber of ouestions. A full coa>>liaent of coa*>onents will be generated 

>» and aost optional *>ereaeters will be filled in with predefined values* 

> » If a value has not been defined for s parameter* NETGEN will ask. the 

>? reouired ouestions. 

>i 

>t 09.00 Do sou want a standard function network CD»N3? CY/N3. N 

>« 10.00 Should all eearonents be generated CD«N3? CY/N3S Y -. 

>* 11.00 Should old files be deleted CD»N3? CY/N3: Y 

>) 

>* <E0S> Do sou want tot 

>* <RET>-Continue» R-Re»>eet section* P-Pause» E-Exit CS3. 

> J 
>i 

> f »tisiiiiitiaii»ia»»i>f»i3iiitfiimit»s»if»i3isti3u»3»3i3a 

>» NET - Section 2 - Define the target swstea 

> i ssaaxsaasssassasssssBsxssassssssassaasasssxssaissaaissssssxasasiasssssss 
>» 

>* 02.00 RSXMC.rtAC location (ddu.Cs»a3» D»DR03. C011»0101> CS3. 

>» 

>* DR03.r.011»0103RSXMC.MAC is being copied to DR03. C300»0103RSXMC.«AC 

>» 

>» DR03.C300*0103RSXHC.MAC is being scanned to define sour target sustee. 

>i This saw take up to several ainutes. 

>i 

>i The target is an RSX-tlM-PLUS ssstea* with... 

>i A 20K-Executive 

>» Kernel data space enabled 

> » Extenoed aeaor* *uwori (aore than i24K words of aeeoryj 

>* UMR support 

>* Multi-user protection 

>» Extended instruction set <EIS> 

>» Powerfail recovers support 

>f Dsnaeic task checkpoint allocation 

>i PLAS support 

>r Queue Manager <QMG) support 

>i 

>* Checking for reauired library files and tasks. 

> i 
>i 

>i Creating UFO for DR03 : C300.0243 

>r Creating UFD far DR03: C300*0543 

> » 

>* 04.00 RSX11M.STB location (ddu.Cg.a3* B=DR03t C001 ,0543 ) CS3t 

M 
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DR03:C001»0343RSX11M.STB is beina copied to DR03: C300f 0543RSX11M.STB 

OS. 00 Should tasks link, to the Supervisor Hod* FCS library CI>»N3? . CY/N3 : u 
06.00 Should tasks link to the Httory Residant FCS librar* CD»N3? CY/N3:*- 

The DECnet CEX Product will be senerated. 

Routin* or non-routina nodas can ba sanaratad froa your distibution kit. 



<EQS> Do you want to! 

<RET>-Continuat R-Repeat section* P-Pauset E-Exit CS2: 



»iiHii»iii»iixiHiiiii»isi»3iit<iiii»iii»i>it»>a»»m»:ii 

NET - Saction 3 - Dafina tha svstaa linas 

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaxaaaaaasasa 

01.00 Davica Drivar Procass naaa C<RET>>Done3 CS R:0-33t 

Tha Davica Drivar Modula (DDM) Procass naaa idantifias a* process 
which controls an I/O davica. Entar a carriaaa raturn whan thara ara 
no tort davicas to support. 

Tha lasal DECnat davica drivar procass naaas ara! 



Naaa 



Physical davica 



DL 


DL11 


DZ 


DZ11 


KDZ 


KMC11/DZ11 


PCL 


PCLU 



>* 

>* 
>f 

>« 
>* 
>* 
>; 
>* 
->* 
>« 



Naaa Physical davica 

DMC DMC11 or DMR11 

DMP DMP11 

DO DU11 

DUP DUP11 

DV DVH 

KDP KMC11/DUP11 

UNA DEUNA 

01.00 Davica Drivar Process naaa C<RET>»Dor.e3 CS R:0-33: DMC 

02.00 How aany DMC controllers are thera CD R:i.-14. D:i.3J- - 

03.01 CSR address for DMC-0 CO R: 160000-177777 0:1777773: 160120 

03.02 Vector address for DMC-0 CO R*.0-774 U'.Qll 330 - -. - 

03.03 Device priority for DMC-0 CO RM-6 D:53: 3 - -- 

04.00 Is DMC-0 a FULL or HALF duplex line CD»FULL3 CS3J 

04.01 Line speed for DMC-0 CD R:30. -36000. 0:56000.3: 

04.07 Sat the state for DMC-0 ON when loading the network. CD»N3? CY/N3: YES 



-1 3- 
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>* 01.00 Device Driv«r Process naee C<RET>«Done3 CS RJO-33: DUP 
>* 02.00 Ho** een* DUP controllers are there CD R:i.-14. D:i.>: — 

>* 03.01 CSR address for DUP-0 CO RU60O0O-177777 DII777773J 160070 

>* 03.02 Vector address for DUP-0 CO RSO-774 D:03: 320 -- 

>* 03.03 Device >>riorit* for DUP-0 CO R:4=6 D:52: 

> » 

>* 04.00 I* DUP-0 3 FULL or HALF duplex lin« CD-FULL2 CS3i 

>* 04.01 Line s««eed for DUP-0 CD R'.30.-9600. D:?600.3: 

>* 04.07 Set the state for DUP-0 ON when loadin* the network. CD»N3? CY/Ni: Y 

;>* 05.00 Is DUP-0 eulti>»oint CD»N1? CY/N3: H 

>i - 

>t 01.00 Device Driver Process neee C<RET>»Done3 CS R:0-33t 

>f - 

> » 

>» <£0S> Do «eu want to? 

>* <RET>-Continue» R-Re>>eat section? P-Pause» E-Exit CS3I 

>» 

>* - 

>i NET - Section 4 - Define the CEX Systee 

> i ■■aas'sssasiassmasasasssssssssssssssiansaassssssaaisisssasasssssBsass 



>» Creatine build files for CEX; the coeeunications executive. 

>i 

>i Atteei»tine to determine the value of sCEX in the RSX-11M-PLUS Exec. 

> » S**ace for CEX (the Coeeunications Executive) was generated within the 
>i RSX-11H-PLUS Executive at address 66560. 

>> ftetwork. events will be loeeed. 

>i - 

>i Creatine" build files for STCRC. the CRC16 calculation routine. 

>» 

>* 03.00 Does the tarset systee have a KB-il CD=*n? CY/N3: N 

>» Creatine build fil»» for CETABr ths CEX eonf isuration tables. 

>i 

>» Creatine build files for the DDHst the device driver aodules. 

>» 

>; DMC 

>i ■-* DUP 

>T - 

•* i 

>? <E0S> Do vou want to: 

>« <RET>-Continue» R-Re»»eat section? P-Pause» E-Exit CS3: 

N t 
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>» .- 



>t NET - Section 3 - Define the Con* Exec Su*»*ort Coe»onents 

> ; IltlIII>i:il»lllI»llIll»>attSII131llI111311tlHIl»l>ll<I]»113313 

>; 

>» Creatine build files for NTINIT» the network, initializer. 

>» 

>» C-reatina build files for NTL» the network loader. 

>i 

>t Creatina build files for EVL/EVC> the event loaaer and collector. 

> J 

>* 06.01 How nan* Event Buffers should EVL use CD RM.-30. Dt6.3t 10 
/>* 06.02 Should EVC su»»ort file event loaaina CD»N3? CY/NK N - ~ 
< >* 06.03 Should EVC su»»ort eoni tor event loaaina CD»N3? CY/N3: N-> 

>* 06.04 Should EVC su»»ort reeotiTevent loaaina CD-N3? CY/ND: N 
'->» -• 

>{ 

>i <E0S> Do *ou want toJ 

>< <RET>-Continue» R-Re»eet section* P-Pause» E-Exit CS3S 

> i 

> J liaiIIII13Slltaill333I<ISItSltSXMIIII>t311IllllXlII3311IIIISI131IZI3 

>> NET - Section 6 - Define the Svstee Manaaeeent Utilities 

> f aaaaaaaaaaaaaaaaaaaaaa*aaaaaaaaaaaaaaaa8aaaaaaaaaaaaSa3aaaa*aaaaaaa3:a 

> i 

>i Creatina build files for NCP» the network, control »roaraa. 

> i 

>i Creatina build files for NHVACP and NMDRV* the Network, Hanaaeeent 

>! Volatile ACP and driver. 

>» 

>i Creatina build files for CFE* the conf iauration file editor. 

>? 

>» Creatina build files for NDA» the network due* analyzer. 

> f 

>» - 

M <E0S> Do sou want to: 

>* <RET>-Continue» R-Re»eat section* P-Pause» E-Exit ZSll 

>i 

>i r 

> i I33a3I3IIiaa33a33X13I3ai3IIIIIfIIlII<I311IlXIIIl>iaiI33:t333II13:33I3 

>; NET - Section 7 - Define the CEX Products 

> i iaaaaia3iiaiiiiiiiiiiiaisiaaaaiiiii3iii:aa:3iis:xa:i>iiiiiii33ii:3:ii 

> i 

>» Questions coneernina the followina CEX Products will now be asked. 

>i 

>i DECnet 
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> | xaxsaxxsssssssssxxxxxxxsssBasssssxsxxaxxxxssssssxaxxxxxxssxxxsxsssxsx 

>l DEC - DECnet CEX Product Generation Procedure 

>} Starting auestions at 14:13:11 on 13-DEC-83 

> j H12»IXiliaiiiiiSiiS:iS:::::!!39 3 S3»3XS»*33»X333X3333X33X333 33333333 

V i 

>i Coi»srisht (C> i981» 1982* 1983 bs 

>t Disital EauiPeent Corporation* Masnard* Mass* 

>; 

>» Generate the DECnet CEX Product for sour RSX-11M-PLUS tarset 

>■ Sysiee,. 
>» 

> | xaX3X3XXS3XX3XX33X3XX3X3X3XXX33SX3XXX3S3X333X3XXXX333X3S3S33X3SX3S333 

>» DEC - Section 1 - Define the taraet and reeote nodes 

> J 3XXXX3XXX33XXS3X33SXXX333XSX33X3333SX33333S3X333XXXXX33333a333333X3XX 
>f 

>t 01.00 What is the taraet node naee C3 R:0-63: ET 

>* 02.00 What is the taraet node address CD R: 1 . -1023-.3 1 4 

>* 03.00 Tarset node ID CD»None3 CS Rt0.-32.3: ET-The Extratef estrial (sic) 

>* 04.00 Do sou want to senerate a routina node CD«#3-?--CY/N3 : s — — 

>* 05.00 Hiahest node address in the network. CD R:&.-1023. DJ6.-K SO 

>» -- n 

>f To include support for products layered on DECnet sou eust first 

>» include the reauired extended network, support. 

>l 

>t 06.00 Do sou want to include this txtended network support CD»N3? CY/N3: 

>! 

Answer this auestion YES» to include the extended network, support for 

the following options: 



- Products lasered on DECnett 

- X*25 Gateway Access 

- SNA Gateway Access 

If sou do not include the extended network, support* sou will not be 
able tg include th««e features in sour network. Including this 
support will cause ECU and NETACP to increase in size bs a total of 
1300. words. 

You eas add the extended network support later bs ^erfomina a 
Component Mode aeneration. 
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>* 06.00 Do you want to include this extended network su^ert CD»N3? CY/N3J Y 
>t 07.00 Reaote nod* naae C<RET>«Done3 CS R:0-6K ZQRRO 
>t 07.01 Reaote nod* address CD RM.-50. DJ1.3: 7 -. 
• J ■"" 

>* 07.00 Reaote node naae C<R£T>»Done3 CS R:0-63: CHICO 

>> 07.01 Reaote nod* address CD R:i.-30. D:8.3: 16 . 

>$ 

>f 07.00 Reaote nod* naae C<RET>»Don*3 CS R:0-62: GRUMPY 

>* 07.01 R*aot* nod* address CD R:i.-50. DU7.3: 8 

>i 

>* 07.00 R*aot* nod* nam* C<RET>»Done3 CS R:0-63: 

Th« DECn*t MACRO us*r library and FORTRAN/C080L/BASIC+2 library will 
b* included. 



Th* DECn*t MACRO user library will b* placed on your tars*t disk 
as *DR03:C1»13NETLXB.HLB'. 

Th* DECn*t F0RTRAH/C0B0L/BASIC+2 object library will b* placed on your 
tarset disk as 'DR03:C1 , 1DNETF0R.QLB* . 

If ntctitirvf Mease aov* thea to th* library disk (LB!) on your 
tars*t systee* if this is different fro* your tarset disk (BR03i). 

<E0S> Do you want to: 

<RET>-Continuer R-Re^eat section* P-Pause* E-Exit CS3* 



aaaaaaaaaaaaaaaaaasssaaasssaaassaaaaasaaasaassssssaaasssssssaaasssaaa 

DEC - Section 2 - Define the DECn*t Coaaunications Coaponents 

ssaaaaaaaaaaaassasaaaaaasaaasssaaaaaaaaasaasaaaaaaaassssssssssasssass 

Creatine build files for XPTt the transport process. 
Creatine build files for RCPt the routin* event processing task. 
Creatins build files for ECL» the network services process and driver. 
Creatine, build files for NETACPi the network services ACP. 



>» 05.01 Should NETACP be checkpointable CD«rO? CY/N3: Y 

>i •• r% 

>r Creatine build files for DCP» the DDCMP line protocol process. 

> i 

>; 

> » <E0S> Do you want to! 

>t <R£T>-Continue» R-Repeet section* P-Pause* E-Exit CS1J 
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,■■ * 

> f ■lltlIIIIillI»UI»lIIll»t<S>3""I»»" , *»>" ,:a * I< ' s *< 3 "» < *" 

>» DEC - Section 3 - Define the DECnet Network Management Components 

"/ ) SSS8iiIf>lt93IIXlIlflSXIt»lIXIll»3I>S»ltlIlI3IlXltllII<:iSlX»l»3 

> » 

>* Creating build files for NICE* the network information and control 
>* iSrvf f task* 

>» 

>» Creating build files for EVR* the network event receiver task. 

>» 

>* 03.01 Include file event logging CD»N3? CY/N3: 

>J 

>» File logging allows EUft to append event data to a system wide event 

>i log file. Answer this Question YES if sou wish to include support for 

>» this option* and NO otherwise. -■- — ■ --- 

>» 

>* 03.01 Include file event logging CD»N3? CY/N2S N 

>t 03.02 Include monitor event logging CD*N3? CY/NK " 

>i 

>» Monitor lossini allows EVR to hand event data to a user written task 

>» for later processing. Answer this ouestion YES if you wish to include 

>» support for this option* and NO otherwise. 

>; 

>* 03.02 Include monitor event logging CD»N3? CY/N3*. N 

>» - -. 

>? Creating build files for NTD* the node state display task. 

> » 

>i Creating build files for NTDEM0* the node state display server task. 
>» 

>i Creating build files for LIN* the link watcher task. 

>i 

>i C-reating build files for L00i the loop test sender task. 

>i 

>• C-reating build files for KIR* the loop test airror task. 

>» 

>» Creating build files for NVP» the network connect verification task. 
>» 

'>{-—■ 

>* <E0S> Do you want to! 

>< <RET>-Continue* R-Repeat section* P-Pause* E-Exit CS3: 

>* 

>* 

>* DEC - Section 4 - Define the DECnet Satellite Support Components 

> t 333xx3xiaai3Xiaaxa3a:iza3x>iiiix333:3iii3ix3:3i = 3i=xz33:3Xia:3i3ii3 3: 

>; 

>t 02.00 Do sou want the Satellite Support Components CD»N3? CY/N3*. 

>» —. 

>> The DECnet Satellite Support Components artl 

> » 

>* DLL - The down-line system loader* host component 
> » DUM • - The up-line system dumper* host component 
>» HLD - The down-line task loader* host component 
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If you answer YES to this autitiom all of tht Satellite Support 
Components will be generated. If vou answer this Question NO? you can 
add these components by do ins a Component Mode Generation. 

* 02.00 Do you want the Satellite Support Components CD-N3? CY/N3: Y 

Creatine build files for DLL? the down-line system loader? host 
component. 

Creatine build files for DUM? the up-line system dumper? host 
component. 

Creating build files for HLD? the down-line task loader? host 
component. 

06.01 Number of incoming connections to support CD R*.l.-32. DM.3: 

Enter the number of simultaneous incoming connections that HLD should 
accept. This will limit the number of down-line task, loads which can 
be performed at the same time. 

06.01 Number of incoming connections to support CD RJ1.-32. DJ4.3* 2 

To generate the HLD data base which describes the tasks to down-line 

load? you may execute the HLDDAT.CMD command procedure at any time 

after your network feneration is complete. This command file will be 
located as follows. 

DR03: C300.0013HLDDAT.CMD 

<E0S> Do you want to! 

<RET>-Continue? R-Repeat section? P-Pause? E-£xit CS3: 



DEC - Section 5 - Define the DECnet File Utilities 

3333333333333333333333333333333333333333333333333333333333333- -333333 

Creating build files for NFT? the network file access user task. 

Creating build files for FTS? the network file access spooler 
user task. 

Creating build files for FAL? the network file access server. 



FAL will support RMS file access. 

FAL will be a multi-copy object. 

FAL will not be ov#^layed. 
>* 04.03 Do you want u use Supervisor mode RMSRES CD»N3? CY/N3: 
>t 04.07 User data buffer size CD Rt260.-1024. D:312.3: 
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>f Creatine - build files for HCM» the network coeaand or batch file 
>» subaission server, 

>8 03.01 Should reauests be Queued to Batch CD»N3? CY/N3 5 

>i " - 

>i If you answer this auestion YfS» NFT Subait </SS> arid Exacytt (/EX) 

>} reauests will be entered into the Batch aueue for execution. 

>i 

>i If sou answer N0» the reauests will be sent to the Indirect Coaaand 

>i File processor (AT.). 

>t 

>* 05.01 Should reauests be aueued to Batch CD«N3? CY/N3: N 

>i ~ ~ 

> i 

>i <E0S> Do sou want tot 

>t <RET>-Continue» R-Re*eat section* P-Pause» E-Exit CS3J 

>» 

> i — 

> f aaaaaaaaaaaaaaaaaaaaaaaamaaaaaaaaaaaaaaaaaaaaaaaaaaaaasaaaaaaaaaaaaaa 

>* DEC - Section 6 - Define the DECnet Terainal and Control Utilities 

> $ aaaaaaaaaaaaasaaaaaaaaaaaaaaaaaaaaxaaaaasaaaaassxasssxsaaaaaaaaaasasa 

>f Creating build files for RMT and RMTACPj the reaote network, terainal 

>i task and ACP. 

>r 

>S 02.01 haxiaua nuaber of siaultaneous RMT users CD RJ1.-13, DM,31 S 

>» - ...... 

>t Creatine build files for HT: and RMHACP» the reaote network terainal 

>l driver and ACP» 

>» 

>t 03.01 Nuaber of incoain* connections to support CD RJ1.-16. DJ4.3! 

>i 

>f Enter the nuaber of siaultaneous incoain* connections that RHHACP 

>? should accent. This will liait the nuaber of network tereimal users 

>> that can los onto sour swstea at the saae tiae. 

>» 

>* 03*01 Nuaber of incoains connections to su*»>ort CD RJ1.-14. DI4.35 

>* 

>? Creating build files for TLKf the reaote talk user task. 

>f .. ... - 

>r Creatine build files for LSN» the reaote talk server task. 

>i 

>i Creatine build files for TCL» the reaote task control server task. 

> t 

"s i 

>? <E0S> Do sou want to! 

>* <RET>-Continue* R-Re^eat section* P-Pause> E-Exit C S3 1 
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DEC - DECnet CEX Product Generation Proetdurt 

DECnet auestion/ansuer section co»»>leted at 14:23:01 on 13-DEC-83 



>i ■- 

>» NET - Section 8 - Complete the CEX Systee Definitions 



> i 



>i Creating build files for DLX» the Direct Line Access process. 



>f 02.00 What is the Larse Data Buffer <LDB> size CD R: 192.-14 



Exit CS 



84. d:2 



>» <E0S> Do you want to: 

>* <RET>-Continuef R-Re^eat section* P-Pauset E- 

>$ 

>» ~\ 

>; m. >»««.«>«»««. ..« a3 >.«s««. «...««>«**. ««.«>. 3 . *«. ...,*«.». «*.„*., 

>» NET - Section 9 - Build the CEX Svstea at 14:23:30 on 13-DEC-83 



92.3: 



>> 

>» All Questions have now been asked and the selected c 

>» be built. This eaw take fro* one to three hours* 

>> selection of components and the suite* you art runni 

>} 

>PIP-DR03:C300tOS4 3CETAB.MAC/PU/NM 

>PIP DR03:C300»054 3AUX.DAT/PU/NM 

>l 

>SET /UIC»C1»23 

>lbr ou:nethlp.ulb/cr:io:: :uni 
>pip ou:nethlp.ulb/pu/nm 

>SET /UIC»C300*243 
>SET /UIC»C1*23 

>lbr ou:ci»23ncp.hlp»in:ci.23nethlp.hlb/ex:nci 



oa.»onen 
de»>endi 
ns on. 



ts will 

ns on 



now 

the- 



>LBfc-,0U : C 1 1 23NCPCLE . HLP* IN : C 1 

>lbr ou:ci»23ncploa.hlp»in:ci 

>LBR-OU:Clr23NCPLOO.HLP»IN:El 

>lbr ou:ci»2:ncpset.hlp»in:ci 

>LBR-:0U:Clt23NCPSH0.HLP*IN:Cl 

>lbrou:ci»23ncptri.hlp»in:ci 

>LBR 0U:C1»23NCP2ER.HLP«IN:C1 

>lbr- ou:ci»23nethlp.ulb»ou:ci 

>LBPrOU:Cl»23NETHLP.ULB»OU:Cl 

>lbr-ou:ci»23nethlp.ulb*ou:ci 
>lbr-0u:c1»2]nethlp.ulb»0u:c1 
>lbr"0u:c1»23nethlp.ulb«0u:c1 
>lbr-0u:c1.23nethlp.ulb«0u:c1 
>lbr-0u:c1»23nethlp.ulb«0u:c1 



»23nethlp.hlb/ex:nc1cle 
»23nethlp.hlb/ex:nc1lqa 
»23nethlp.hlb/ex:nciloo 
»23nethlp.hlb/ex:nciset 
»23nethlp.hlb/ex:ncisho 
i23nethlp.hlb/ex:ncitri 
»23nethlp.hlb/ex:ncizer 
»23ncp.hlp/rp 

.23ncpcle.hlp/rp 
►23ncploa.hlp/rp 
.23ncplqo.hlp/rp 

f23NCPSET.HLP/RP 
»23NCPSH0.HLP/RP 
»23NCPTRI.HLP/RP 
»23NCPZER.HLP/RP 



>lbr- ou:ci»23nethlp.ulb»ou:ci 

>pip ou:ci»23ncp.hlp*»/de/nm.ncpcle.hlpj*.ncplqa.hlp;* 

>pip-0u: cli23ncploo.hlp5*/de/nm»ncpset.hlp{*.ncpsho.hl? 

>PIP-OU:Cl»23NCPTRI.HLPi</DE/NHfNCPZER.HLP;t 
>SET /UIC»C300»243 
>SET /UIC»C1»23 



it 
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>lbr ou:ci»23CFE.hlp«in:ci»23nethlp.hlb/ex:cfi 
>lbr-ou : c 1 . 23cfedef . hlp-in : c 1 t 23nethlp . hlb/ex : cf 1def 
>lbr~ou:ci»23CFElis.hlp«in:ci»23nethlp.hlb/ex:cfilis 

>LBft-QUSCl»23NETHLP.ULB*0U:Cl»23CFE.HLP/RP 

>LBR- OU I C 1 » 23NETHLP . ULB-QU t C 1 » 23CFEDEF . HLP/RP 

>LBR--OU : C 1 f 23NETHLP . ULB»OU J C 1 » 23CFELI S . HLP/RP 

>PIP 0U:C1»23CFE.HLP»»/DE/NM»CFEB£F«HLPJ*»CFELIS.HLP;* 

>SET /UIC»C300»243 

>SET /UIC»C1»23 

>LBR OU'. C 1 » 23NDA . HLP»IN : C 1 » 23NETHLP . HLB/EX : NDA 

>LBR- OU *. C 1 » 23NETHLP . ULB-OU : C 1 » 23NDA . HLP/RP 

>PIP-OU:Cl»23NDA.HLP!*/M/NH 

>SET /UIC»C300f243 

>i 

>TKB 9OU5C3O0t243CEXBLD.CMD 

>PIF—,QU J C300»543CEX. TSK/PU/NM »CEX. STB »AUX.TSKrAUX. STB 

>TKB eOU:C300f243STCRCBLB.C»D 

>P IP--OU:C300f 54 3 STCRC. TSK/PU/NM iSTCRC. STB 

>MAC 90U:C300. 243CETABASM.CMD 

>PIR^OU:C300t 24 3CETAB. OBJ/PU/NH 

>TKB 80UtC3OOt243CETABBLD.CMD 

>PIP-QU:C30O»543CETAB.TSK/PU/NMfCETAB.STB 

>TKB 90U:C300»243NTINITBLD.CND 

>PIR-»QU:C30O»343NTINIT.TSK/PU/NH 

>STK , "tOU:C300t243NTLBLD.CMD 

>PXf*«tOU: C30O. S43NTL . TSK/PU/NM 

>MAC* 90U:C300f 243EVLASH.CMD 

>PIP~OU: C300»243EVLDAT .OBJ/PU/NH 

>TKB 80U:C300»243EVLBLD.CMB 

>PIP- r 0U:C300»543/NV»INt C131t243EVL.DAT 

>PIP " OU J C300 » 54 3EVL . TSK/PU/NM f EVL . STB » EVL . DAT 

>TKB 90U:C300»243EVCBLD.CMD 

>PIF-|OU:C300»543EVC. TSK/PU/NM 

>TK8 90U:C300»243NCPBLD.CHD 

>PH*jOU:C300f543NCP. TSK/PU/NM 

>MAC 80U:C300t243NHyACPASM.CMD 

>PIP-t0U:C300»243NM0RV. OBJ/PU/NH »NHTAB. OB J 

>STK 80U:C3OO»243NHVACPBLD.CMB 

>PIP-^OU : C300 . 54 3NHVACP . TSK/PU/NM » NMDRV . TSK » NMDRV . STB 

>PIP*0U:C300»343/Ng/C0»IN:C132»543CFE.TSK 

>PIP0U:C300t543CFE. TSK/PU/NH 

>PIP 0U:C30O»543/NV/C0»IN:C141t543NDA.TSK 

>PIP 0U:C300»543NDA. TSK/PU/NM 

>MAC 80U:C300»243DLXASM.CMD 

>PIB-.0U:C300i 24 3DLXT AS. OBJ/PU/NH 

>TKB 80U:C300»243DLXBLD.CMD 

>PIFrr.OU :C300. 34 3DLX.DAT/NV« IN: C131f243DLX.DAT 

>PIP'OU:C300t543DLX.TSK/PU/NMf DLX.STB.DLX.DAT 

>PIP 0U:C30O»543DLXTAB. TSK/PU/NM .DLXTAB. STB 
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>TKB 90U:C300»243DMCBLD.CMD 
>PIP~iOU:C300»343DMC.TSK/PU/NMfDMC.STB 
>PIP 0U:C300»343/NV»IN: C131i243DMC.DAT 
>PIP OU:C30O»343DMC.DAT/PU/NM 
>TKB 80U:C300i243DDHARBLD.CMD 
>PIP-QU:C300t34 3DDHAR.TSK/PU/NM»DDHAR.STB 
>TKB 90U:C300»24]DUPBLD.CHD 
>PIP~OU:C300»343DUP.TSK/PU/NM>DUP.STB 
>PIP 0U:C300»343/NV- IN'. C131t243DUP.DAT 
>PIP QU:C300t543DUP.DAT/PU/NM 
>SET /UIC»C1»13 

>lbr ou:ci>i3netlib/cr:i:o:i2S. :mac»in:ci30»io3Dlxdf,mac 
>lbr ou*. c 1 » 1 3netlib . mlb»in: c 130 1 103epmdf . mac »chrdf . mac 
>lbr-0u:cl>13netlib.mlb»in:cl30»10:netdef.mactnetmac.mac 

>LBR- 0U:Cl»13NETLIB.MLB»IN:C130rt03NFAMAC.MAC 

>pip 0u:cl»13netlib.mlb/pu 
>lbr-ou:ci>i3netfor.obs»in:ci33»243Dapfor/ex 
>ibr- ou:ci»13nettmp.obs»in:ci33»24:daptrc/ex 

>LBR 0U:Cl»l3NETF0R/C0:iJ320.:i92.»IM:Ct34t243NETF0R.0LB 
>LBR OU : C 1 t 1 3NETF0R/IN-0U : C 1 t 1 3NETF0R . OBS 

>lbr"-ou:cl»13netfor/in/-ep»ou:cl»13netthp.qbs 
>lbr ou:ci»13netfor/dg:*mblun:*astbl:*astlu 

Entr* joints d»l»t»dt 

*MBLUN 

♦ASTBL 

•ASTLU 

>PIP OU:Cl»13NETFOR.OB3f*/DEfNETTMP.OBS»* 

>PIP OUUlf 13NETF0R.0LB/PU 

>SET /UIOC300.0243 

>PIP OU : C300» 024 3/NV- IN: C137f243NTEST.CMD 

>PIP 0U:C30O»O243NTEST.CMD/PU/NM 

>SET /UIC»C300»0543 

>PIP 0U:C300t034 3/NV/C0»IN:Cl33»343DTS.TSK»DTR.TSK 

>PIP0U:C300t054 3DTS.TSK/PU/NM»DTR.TSK 

>5ET /UIC»C300»0243 

>TKB eOU:C300t243XPTBLD.CMD 

>PIP-.0U:C300r543XPT.DAT/NV» IN: C13lf243XPT.DAT 

>PIP 0U:C300.343XPT.TSK/PU/NM» XPT.STBfXPT.DAT 

>TKB 90UtC300.243RCPlBLD.CMD 

>PIP-?0U'.C300t543RCPl.TSK/PU/NM 

>MAC 90U:C300»243ECLASM.CMD 

>FIFWOU:C300»243ECLTAB.OBJ/PU/NM 

>TKB *9OU:C3OO»243ECLBLII.CM0 

>PIP-.0U:C300»543ECL.DAT/NV»IN: C131t243ECL.DAT 

>PIP OU : C300 » 543ECL.TSK/PU/NM»ECL. STB fECLTAB.TSK. ECLTAB.STB.ECL.DAT 

>TKB 80U:C300t243NETACPBLD,CMD 

>PIP-OU:C300t543NETACP.TSK/PU/NM»NETACP.STB 

>TKB '80U:C300»243DCPBLD.CMD 

>P IP - OU : C300 »343/NV« IN :C 131 » 243DCP.DAT fDCPST.DAT 

>PIP OU : C300 1 54 3DCP .TSK/PU/NH » DCP . STB» DCP . DAT , DCPST . DAT 

>TKB »0U:C300t243NICEBLD.CMD 

>PIP-jOU:C300»54 3NICE.TSK/PU/NM 

>TKB 80U:C300t243EVRBLD.CHD 

>PIF^0U:C300»54 3EVR.TSK/PU/NH 
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>TKB 80U:C300»243NTDBLD.CMB 

>PIP-.<3U:C300»54 3NTB.TSK/PU/NM 

>TKB SOU 1C300 » 24 3HTDEHOBLB. CHD 

>PIP-iOUSC300f543NTBEHQ.TSK/PU/NH 

>7K3 SOU « C300 » 24 jLIHSLD . Cnu 

>PIP-jOU:C300»343LIN.TSK/PU/NM 

>TKB 80U:C30Q»243L00BLD.CMD 

>PII*-QU:C300»543L00.TSK/PU/NM 

>TKB 80U:C300i243MIRBLD.CHD 

>P IP^-.OU : C300 » 543MIR . TSK/PU/NM 

>TKB 80U:C300t243NVPBLD.CHD 

>PIF*-iOU t C300 » S43NVP . TSK/PU/NM 

>TKB 80U:C300t243DLLBLD.CMD 

>PIP*»0U:C300»543DLL. TSK/PU/NM 

>PIP 0U:C300»343/NV/C0»IN:C136f543SEC*.SYS»TER*.SYS 

>PIP'OU:C300»54 3SEC*.SYS/PU/NM>TER*.SYS 

>TKB eOU:C300i2430UHBLO.CHO 

>PIEM3U:C300tS43DUM. TSK/PU/NM 

>TKB 80UtC300.243HLDBLD.CMD 

>PIP-OU: C30Of 543HLD. TSK/PU/NM 

>PIP 0U:C300.13/NV«IN: C132.243HLDDAT.CMD 

>PIP 0U:C300.13HLDDAT.CMD/PU/NM 

>TKB 80U:C300»243NFTBLD.GMD 

>PIR-,QU:C30O»343NFT, TSK/PU/NM 

>SET /UIC-C1>23 

>lbr ou:ci»22nft.hlp»in:ci»23DEChlp.hlb/ex:nft 

>LBft- OU : C 1 f 23NETHLP . ULB»0U t C 1 » 2 3 NFT . HLP/RP 

>PIP--OU;Clt23NFT.HLPf*/DE/M« 

>SET /UIOC300.243 

>MAC 80U:C300. 243FTSASM.CMD 

>TKB- SOU*. C300t243FTSBLD.CMD 

spTp^nu? r3(j^,54TCTS . TSK/PU/MMyFTSBEQ * TSKf FTSPRMsQBJ 

>SET /uic»Clr23~ 

>LBR ou:ci»23fts.hlp»in:ci»23DEChlp.hlb/ex:fts 

>LBR 0U:C1»23NETHLP.ULB»0U:C1»23FTS.HLP/RP 

>PIP- QU? Cl?23FTS-MLP? */DE/MM 

>SET /UIC»C300>243 

>MAC 80U:C300t 243FALASM.CMD 

>PIP-0U!C300»243FALPRM.0BJ/PU/NM 

>TKB 30U:C3OO»243FALBLD.CMD 

>PIP~0U:C300t543FAL. TSK/PU/NM 

>TKB 80U:C30O»243MCMBLD.C«D 

>PIPr*0U:C300» 34 3MCM. TSK/PU/NM 

>MAC 80U:C30O. 243RMTASM.CMD 

>PIP— OU:C300»243RMTACP.QBJ/PU/NM 

>TKB eOU:C30O»243RHTBLD.CMD 

>PIP-QU:C300»543RMT. TSK/PU/NM, RMTACP.TSK 

>HAC 80U:C300t 243RMHACPASM.CMD 

>PIP , *^U:C300»243RMHACP.0BJ/PU/MM.HTTAB.0BJ 
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>TKB (»0U:C3OO»243RMHACPBLD.CMD 

>PIrVOU : C30O » 34 3RMHACP . TSK/PU/NM » HTDRV . TSK t HTDRV . STB 

>TKB (?0U:C300. 243TLKBLD.CMD 

>PIF~0U:C300»343TLK. TSK/PU/NM 

>TKB eOir.C300i243LSNBLD.CMD 

>PIP-OU:C300»34 3LSN.TSK/PU/NH 

>MAC 90U:C3OO»243TCLASM.CMD 

>PIP-0U:C3OO»24 3TCLPUD.0BJ/PU/NM 

>TKB eOU:C300t243TCLBLB.CMD 

>PIP~OU:C300»543TCL.TSK/PU/NH 

>i 

3333333333333333333333333x333333x33333x33333333x333: 

NET - Section 10 - Generation Clean u> 

3333333333333333333X33333333333333333333333333X3333: 



Creatine NETCFG.TXT» the network, configuration description file. 
Creatine NETCFE.CMD* the network, configuration coeaand file. 
Creatine NETINS.CftD* the network installation coeeand file. 
Creatine NETREM.CHDi the network reeoval coeeand filt. 

The network HELP file library has been »laced on your tarset disk* as: 

DR03:Cl»23NETHLP.ULB 
This file should be aoved to your taraet svstees library devict CLBI) 



NET - RSX-11M-PLUS CEX Systee Generation Procedure 
Stored at I5:33t39 on 13-DEC-B3 



>9 <E0F> 
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8LB: C300 » 1 3NETINS 
>* Do vou want to install and load the CEX s*ste»? CY/NJ: Y 
>* Do sou want to install and start DECnet? CY/N3: Y 
>* On what device are the network tasKs Cp»DL0:3 CS3 . ■ 
>* What is the network. UIC srou* eod« CO R: 1-377 D:53: 300 
MNS XX:C300.34DNTINIT 
MNS XX:C300t343NTL 
MNS XX:C300»543EVC 
MNS XX;C3QQt542NCP m 
>i INS XX:C300»541CFE 
>INS XX:C300*543NMyACP 

>set /sysuic*c300»s43 

>asn xx:=lb: 

>loa nm:/high 

,>asn =lb: . 

>SET /SYSUlC*Clr34J 

MNS XX:C300»54 3NETACP 

>INS XX:C300»34]NICE 

MNS XX*.C300»543EVR 

MNS XX:C300»54 3NTD 

>INS XX:C30O»543NTDEM0 

>INS XX:C300»543LIN 

MNS XX:C300»343LQ0 

MNS XX:C300t54]MIR 

MNS XX5C300.543NVP 

MNS XX:C300»543NFT 

>INS XX:C300»54 3FAL 

MNS XX:C300f54DMCM 

MNS XX;C300»54 3RHT 

MNS XX:C300»54]RHTACP/CLI»YES 

. CLI MNIT»RMTACP/NULL/RESTRICT/CPR»*<13><l2>/Rr1T>/» 

>SET /SYSUIC«C300»543 

>ASN XXt»LB: 

: loa ht:/high 

'-set /sysuic=c1>543 

>ASN =lb: 

MNS XX:C300»54 3RMHACP 

MNS XX:C300»543TLK 

MNS XX:C300r54 3L3N 

MNS XX:C300»543TCL 

>ASN «xx: 

>SET /UIC*C5»13 

: NCP SET SYS 

J-NCP SET EXE ST4 ON 

Event ty*e 2. Of Local noda state chanse 
Occurred 14-DEC-83 09:38:57 on node 2.231 (ZIRCON) 
Reason for state chanseJ Operator co*»and» Old node state = Off 
New node state 3 On 

>e <E0F> 
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>3LB:C300*243NTEST 

.■■■ r 
;:ii»iiiiii3>iiiiiii:iittisii33»3i»t::3»3i:iiii>iii:iiii>3:>333:i:z: 

:■» t RSX-llrl/H-Plus Network Installation Procedures * 

> f 3I3IlSiaaiIlI3133l:nilllllIIllllIXSIlIllItII13III911I33H3IH131»»lI 

>l Copyriaht (C) 1979r l?80f 1981 > 1982» 1983 by 
>i Oiaitai Eouipment Corporation* haynard* Mass. 

'■'- r 

.>» Test procedure performed at 09*.5A:05 on 14-DEC-83 

> i 

>i This procedure is designed to allow a user to perform the followina 
>» tests on a DECnet-lihVrt-Plus system: 

> J 

; r . Internal Node Level — Test the local node without usina ana 

; ■■ J communication circuits. 

» . Circuit Level — Test the local node with a communications line at- 

; tached to a turnaround/loopoack device or a modem with loopoack 

>? capabilities. 

. ■■■» . Remote Node Level — Test the local node by attempting to communi- 

:. [ cate with a Remote Node. 

> r 

> * 

;■■; The procedure will execute DTS/DTR tests and will use NFT/FAL to 
> j transfer and execute files. 

> f 

'-* Before runnins this procedure* sou should have access to the followina 
■i information: 
.-■ 5 

':■} . The device 3nd aroup code of the UIC under which the network. 

■r tasks are stored. 

'•■■» . The taraet node name (for local tests* this is the local node 

* name) . 

>» . The necessary UIC and password to access files residina on the 
>t taraet node* for NFT tests. 

.> * 
. •■ i 

:* Do you want to: <CR>-continue E-exit P-pause CS3: 

; I :::3:3:s3 3xx3X3i3:3i3i3i3X3:3i33:ixxi3:33i:3iiii3iii3333i3C3i>3:=33:::: 

■•? * Test Parameters * 

>{3:XXS:XX3SXXX3XXXXXXa>XXSX3XXXSS3XXXSXXX3S3XS13XXXXX3XX>X3S3XSICX33S33I 

"' i 

'•■• » If you do not choose lona dialoaue mode* explanatory text for each 
| Question is available by hittina the 'ESCAPE 1 key. 

:■* Do you want lona dialoaue mode? CY/N3: Y 

■ " r 

r Enter the UIC aroup code under which the network files were stored 

■ * for this node's network. 
■■■ J 

* What aroup UIC is the network stored under CO R: 1-3773: 300 

■••» Specify the device on which the network files are stored. The default 
| device is 'SY: ' . 

* On what device are the network files (DDNN) CS R!0-53: SYO 
•■ * 

■i Answer 'YES* to the next auestion if this is an Internal Node Test* 
>i i.e. the test does not involve communications lines and/or remote 

> | nodes. 
■■■ J 

>* Is this an Internal Node Level test? CY/N3: N 

'■■ * 

i If you want to set up your system for the tests* for example issue 

> i some nop commands to define 3 Loopoack Node Name or turn on a liner 

i this procedure will pause. When you are ready* continue with the pro- 

' ceoure . 

* Do you want to pause to confiaure your system 7 CY/NK N 
J 

i Enter the taraet node name ( 1-6 alphanumeric characters). This is the 

J node name of the remote node. If this is an Internal Level test. then 

■ * tne Local Node Name should oe used. If this is a line level test* then 
| the Loopoack Node Name should be used. 

f 

* Uhat is the taraet node name CS RU-63: RSXHUB 
5 

■» DTS will now be invoked to perform three tests! 

i 1.) DTS will issue a connect reauest to DTR causina 

i DTR to be loaded* answer the reauest and task 

■■; exit 

■i 2>) DTS/DTR will execute a 1 minute pattern test 

i usina a 10 byte messaae size 

» 2.) DTS/DTR will execute a 1 minute pattern test 
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usina an 1100 byte aessase size. 

The 10 byte aessaae size was selected because this size is saaller 
than NSP's seseent size... thus there will be 1 sesaent for each 
aessaae. The 1100 byte aessaae size is laraer than the sesaent size; 
tnerefore* there will be auiti-seanenis for each of these nessases. 

:NS SY0:C300»543DTS/INC=600. 
iNS SYO:C300r543DTR/lNC*600. 
>PIP DT3TST.C«D?*/DE/Ntt 
>DTS 3DTSTST 

LOAD/EXEC DTR VIA CONNECT TEST 
DTS — Test finished at 9:37:12 

PAT/HSG*10/TIME=1N 
DTS — Test started at 9*.57:i2 
DTS — Test finished at 9:58:12 
1903 hessaaes sent 

317 Cnaracters/second 
2536 Baud 

DTS — Connect error. .. status 177667 
IP DTSTST.CMDJS/DE/NH 

In order to execute NFT file transfer testsf you oust supply valid 
access control information for the taraet node RSXHUB. This mforaation 
is 

(1). A user identification (the foreat defends on what type of 
systea RSXHUB is. 

(2). The password for that user-id. 

:« What is the user-id for NFT tests on node RSXHUB CS R:i.-16.3t RYAN 

>* What is the correspondina password CS R:0.-S.]t JESSI 

: PIP NFTTSl.ZZZ»*/DE/NnfNFTTS2?*»NFTTS3;*»NFTTS4f*»NFTTS5i* 

'■■ i 

. ■•*? NFT will now be invoked. A copy of the coaaand file NTEST.CMD will be 
>i transferred to node RSXHUB with the filenaae TMPNETTST.ZZZ usina the 
» access control mforaation you specified. NFT will then delete the 

NFT (JNFTTS1 -777/TP 
NFT>RSXHUB/RYAn7 JESSI ::T«PNETTST.ZZZ;i=SY0: C300f24 3NTEST.CMD 

.I The file THPNETTST.ZZZ will now be deleted usina NFT. 

nft 9nftts2.zzz/tr 
nft-p.sxhub/ryan/jessi: :tmpnettst.zzz»i/de 

ip nfttsl.zzzj*/de/n«»nftt32f*»nftts3f*»nftts4;*»nftts5;* 

If you have reached this point with no errors* then you can be 
hishly confident that the node has been created properly. 

End of test at 09:38:54 

333333=333333333=333*33333333333333333333333333333333333333333333333333 

* End of Installation Test * 

333=33=3333=333333333=333333333=333=3===3=33=3X=33333333333333333XX333= 

■:eof> 
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PIP Ti:*C300»3 
.TITLE 
.IDENT 



i Cqpvt 
f Disit 

r 

.MCALL 

SYSSDF 

PDVSDF 

SLTSDF 

LLCSDF 

LLCSDF 

LLC*DF 

LLC*OF 

LLCSDF 

DDMSDF 

CNTSBF 

UNTfDF 

LQG1ST 

ROU*DF 

NQDSDF 

FEASDF 

BUFSDF 

PAR*DF 

OBJ*DF 

QBJSDF 

OBJSDF 

OBJSDF 

OBJSDF 

OBJiDF 

OBJ*DF 

OBJSDF 

OBJ*DF 

QBJ$DF 

E'JT$DF 

EUTiDF 

EVTtDF 

EVTSDF 

EVTSDF 

EVTtDF 

EVTSDF 

EMTSDF 

REMSDF 

REMSDF 

REHSDF 

REMSDF 

REMSDF 

REMSDF 

REMSDF 

REMSDF 

ENDSDF 

EXPPDT 

EXPSLT 

EXPLLT 

EXPSTT 

EXPP'JT 

.LIST 

.END 



43CETAB.MAC 
CETAB 
/V04.0/ 

iaht CO 1982. 1983 bw 

al EouiJ»*ent Corporation* Maynardr Mass. 

SYSSDF 

<RSS11M.M*SNGE> 

<AUX » EVL t ECL r XPT . DLX> t <> . <DMC> 

DHC.DMC.XPTrLF.MFL!LF.ENA!LF.TIMr0rOr t .15. 

AUX»ZF.LLC!ZF.TIM!ZF.MTM!ZF.MFL.O»0. 

•TIMIZF.MFL.O.O. 

TIM!ZF.MFL!ZF.C0U»O»O»10. fNSm».4.»0 

.TIM!ZF.MFL!ZF.COUrOrl. 
TIM!ZF.MFL»0»1. r » NX 
DMC » ZF . DDM ! ZF . DLC ! ZF . COU ! ZF . MAN » 3 t r 1 . 
0.310. 160070»5» »NX 
0»177470. lr »5. 
1 

0. > 1022. »10. .300. fO.rO.rO.> 1022. »0. 

<ZIRC0N>f«:ZIRC0N-ENCRUSTED_TUEEZERS>»2. » 231 . » 2. »231 . 
NS.000627. 100000. 100000 
8. .38. .9. .376. rll. »34.»2.r0. ■ 
.GEN. 17. .TOP. 2 .9. 



EVL.ZF.LLCIZF; 
ECL»ZF.LLC!ZF. 
XPT>ZF.LLC!ZF, 
I'LXrZF.LLCIZF. 



0. t f 2.0.1 

15.»<TCL...>»0»0f 1 
16. .<LSNSSS>r 2.200.5 
17. r<FAL. . .>»0r0rl 
18. . .HLD.. .>» 2.0.1 
19. r-,NIC$»i>» 1»200>3 
23. > :RMHACP>»2»0r 1 
25. >-.MlRSS*>»2r200»3 
26. .<EVRS«S>»2»200.3 
63..<DTR. . .>»2f0»l 
0>< 311 >0r0»0:. .CONSOLE 
200 1 <3 » » » 0> » CONSOLE 
300r<4»0t0r0> .CONSOLE 
400» < 137777 » 5 rO>0>t CONSOLE 
500 .< 160000. 1.0»0>r CONSOLE 
lOOOOr 6»0»0r0>. CONSOLE 
10400. <40000»0r0>0>. CONSOLE 
1 0500 ><1.0>0.0>r CONSOLE 
<VORTEX; .2..1. 
<KERMIT>.2. .60. 
<CASTOR; .2. .62. 
<RSXHUB>t 2. »63. 
<BEING>r2.r93. 
.:HARDY>r2. .149. 
'<ALIEN>.2.r226. 
<SUPER:>2. .230. 
f last edit by TTO C3.23 on 
<AUXrEVL»ECL.XPT> DLX> rO r <DMC> 
<>»<DMC> 
< AUX r EVL . ECL » XPT . DLX> 

<AUX.EVL.ECL.XPT.DLX>f<>r;DMC> 
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CETAB MACRO V03.00 U«4n«sd«« 14-D«c-33 10:43 P»M 3 



3 OOOOOO 



TITLE 
I DENT 



CSTAS 
/V04.0/ 



Co**rUht (C) l?82t 1983 b* 
Diait*! Eaui*««r*t Car»OT«tion> 



N»*n«rd» «***. 



.HCALL 
SYS»DF 



3YS*DF 
<R««UMfM«*MGE> 



PROCESS DESCRIPTOR ADDRESS TABLE 



EACH ENTRY IS THE ADDRESS OP THE CORRESPONDING 
PROCESS DESCRIPTOR VECTOR ( BELOU ). 



OOOOOO 




OOOOOO 


000042 


000002 


000062 


000004 


000102 


000006 


000122 


000010 


000146 


000012 


000172 


000014 





PROCESS PROCESS PROCESS PROCESS 
NAME LEVEL INDEX MFL 



*PDUTBJ 


; 












.WORD 


AUXPDV 


f AUX 


LLC 


0. 


YES 


( a> ; 


. UORD 


EVLPDV 


; SVL 


LLC 


2. 


YES 


(A) i 


.UORD 


ECLPOV 


( ECL 


LLC 


4. 


YES 


iA> ; 


.UORD 


XPTPDW 


i XPT 


LLC 


6. 


YES 


(A) i 


.UORD 


DLXPDV 


i DLX 


LLC 


3. 


YES 


(A) 1 


.UORD 


DMCPDV 


i Dnc 


DDK 


10. 


NO 


(A> ; 


*pdvnd: 


: 













SYSTEM LINE TABLE OFFSETS AND FLAG UORD BIT DEFINITIONS 



OOOOOO 
000002 
000003 
000004 
000006 
000010 
000012 
000013 
000014 
000015 
000016 
000020 
000021 
000022 



OOOOOO 
000007 
000010 
000020 
000040 
000100 
000200 

000400 
001000 



L.FL .j ; 


.BLKU 


1 


l.ddm: 


.BLK8 


1 


L.DLC: 


.BLKB 


1 


l.dds: 


.BLKU 


1 


l.dlm: 


.BLKU 


1 


L.DLS: 


.BLKU 


1 


l.ctl: 


.BLKB 


1 


l.unt: 


.BLKB 


1 


l.nsta 


.BLKB 


1 


i .rn«T 


. SLKB 


i 


L.KRBA 


.BLKU 


1 


L.NHST 


.BLKB 


1 


L.OUNR 


.BLKB 


1 


l.mpf: 






L ?'_»!*■ 








FLAG UORD 


LF.X2P-000000 


; 


LF.BUT*000007 


i 


LF.TIM«000010 


; 


LF.MTP»000020 


i 


LF.SER-000040 


i 


LF.MDC-000100 


i 


LF.PAC> 


000200 


i 



LF.BR0»000400 
LF.LP6»001000 



FLAGS UORD 

DDM PROCESS INDEX 

DLC PROCESS INDEX 

DDM LINE TABLE ADDRESS 

DLC LINE TABLE RELOCATION BIAS 

DLC LINE TABLE ( VIRTUAL ) ADDRESS 

CONTROLLER NUMBER 

MULTIPLEXER UNIT NUMBER 

NUMBER OF TRIBUTARIES ON THIS LINE 

LINE COST FOR ROUTING TASK 

POINTER TO CONTROLLER REQUEST BLOCK 

NETUORK MANAGEMENT LINE STATE/SUBSTATE 

LINE OWNER PROCESS INDEX 

START OF MULTIPOINT FLAG TABLE 

I PNfSTH OF F&(~.U <51_ T FNTRY 



LINE NEEDS PARAMETERS FROM X2PSDF 

BUFFER UAIT QUEUE COUNT 

LINE NEEDS TIMER SERVICE 

LINE IS MULTI-POINT 

CIRCUIT HAS SERVICE DISABLED 

LINE NEEDS MODEM CONTROL 

LINE UAS PREVIOUSLY ACTIVE 

J (BEFORE RECONFIGURATION) 
LINE IS A BROADCAST CHANNEL (ETHERNET) 
LINE IS IN LOOPBACK 
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CETAB MACRO V03.00 W*4rt*«dav 14-D»e-83 10! 43 Pa«« 3-1 



000000 
OOOOOt 
000002 
000003 
000004 



002000 
004000 
010000 
020000 
040000 
100000 



000017 
000360 
000000 
000001 
000002 
000003 
000004 
000000 
000001 
000002 
000003 
000004 
000003 
000006 
000000 



LF.ENA-002000 i LINE IS TO BE ENABLED AT INITIALIZATION TIME 



000200 
000100 
000040 
000040 
000020 

000010 
000004 
000002 
000001 



LF.MFL-004000 
LF.REA-010000 
LF.UNL"020000 
LF.RDY»040000 
LF.ACT-iOOOOO 



* LINE IS HARKED FOR LOAD AT INITIALIZATION TIME 

) LINE IS REASSIGNA8LE 

i LINE IS HARKED FOR UNLOAD 

i LINE IS READY (ODH.DLC PROCESSES AND LINE TABLES ASSIGNED) 

> LINE IS ACTIVE ( LINE IS ASSIGNED TO AN LLC ) 



NETWORK MANAGEMENT STATE/SU8STATE BYTE DEFINITIONS 
STATE » LOW 4 BlfS 
5UBSTATE - HIGH 4 BITS 



LN.STA-17 

LN.SUB-340 

LN.ON"0 

LN.OFF.l 

LN.SER-2 

LN.OAU-3 

LN.00P«4 

LN.CLO-0 

LN.OPE"! 

LN.REF«2 

LN.LOO-3 

LN.LOA-4 

LN. DUN'S 

LN.TRI-6 



STATE FIELD BIT MASK 
SUBSTATE FIELD BIT MASK 
STATE • ON 
OFF 

SERVICE 

ONr AUTOSERVICE 
ON. OPEN 
CLOSED 

OPEN. UNSPECIFIED 
OPEN. REFLECTING 
OPEN. 
OPEN. 



STATE 

STATE 

STATE 

STATE 

SUBSTATE 

SUBSTATE 

SUBSTATE 

SUBSTATE 

SUBSTATE 

SUBSTATE 

SUBSTATE 



LOOPING 
LOADING 
OPEN. DUMPING 
OPEN. TRIGGERING 



MULTIPOINT FLAG TABLE OFFSETS AND FLAG BYTE DEFINITIONS 



S.FLG: 

s.cost: 
s.nmst: 
S.Ounr: 
s.len: 



.BLKB 
.BLKB 
.BLKB 
.BLKB 



FLAGS BYTE 

TRIBUTARY COST FOR ROUTING TASK 

NETWORK MANAGEMENT TRIBUTARY STATE/SUBST ATE 

TRIBUTARY OWNER PROCESS INDEX 

LENGTH OF TRIBUTARY EXTENSION 



FLAG BYTE DEFINITIONS 



SF.ACT-000200 
SF.ENA-000100 
SF.UNL-000040 
SF.MFL-000040 
SF.PAC»000020 

SF.REA-000010 
SF.LPB-000004 
SF.SVC-000002 
SF.SER-000001 



TRIBUTARY IS ACTIVE 

TRIBUTARY IS MARKED FOR ENABLE AT INITIALIZATION TIME 

TRIBUTARY IS MARKED FOR UNLOAD 

TRIBUTARY IS MARKED FOR LOAD (DATA LINK MAPPING ONLY) 

TRIBUTARY WAS PREVIOUSLY ACTIVE 

i (BEFORE RECONFIGURATION) 
TRIBUTARY IS REASSIGNABLE 
TRIBUTARY IS IN LOOPBACK 
OLM CIRCUIT IS AN SVC 
CIRCUIT HAS SERVICE DISABLED 



000014 

000014 000016' 



»sltmb:: 



SYSTEM LINE MAPPING TABLE 

.WORD SLTO i SYSTEM LINE TABLE 

SYSTEM LINE TABLE 
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CETAB MACRO V03.00 



000016 




000016 


006010 


000020 


012 


000021 


012 


000022 


000000 


000024 


000000 


000026 


000000 


000030 


000 


000031 


000 


000032 


000 


000033 


001 


000034 


000000 


000036 


000000 




000000 



3 10:43 


Pas* 


3-2 




ISLTTSS i 








i SLNO 


DRC-0 


-0 




SLTOS 


.WORD 


6010 


(D) s 




.BYTE 


10. 


(D) i 




.BYTE 


10. 


<D) ; 




.WORD 





(I) i 




.WORD 





(I) i 




.WORD 





(I) 5 




• BYTE 





(D> ; 




.BYTE 





(D) ; 




.BYTE 





(A> ; 




• BYTE 


1 


(0) i 




.WORD 





<s> ; 




.WORD 





(D) i 




.REPT 









.BYTE 





(0) 1 




• BYTE 


1 


<D) ; 




-. WORD 





<D) • 




.ENDR 






ISLTNDt: 









FLAG FOR DNCO 

DHC OFFSET IN PDVTB:: 

DHC OFFSET IN pdwtb: : 

DMC LINE TABLE ADDRESS 

DHC LINE TABLE BIAS 

DHC LINE TABLE ( VIRTUAL > AODRESS 

CONTROLLER NUMBER < DHC-O-0 ) 

MULTIPLEXER UNIT NUMBER 

NUMBER OF TRIBUTARIES ON THIS LINE 

LINE COST FOR ROUTING TASK 

POINTER TO CONTROLLER REQUEST BLOCK 

NETWORK MANAGEMENT LINE STATE 

MULTIPOINT TRIBUTARY FLAGS 

TRIBUTARY ROUTING COST 

NETWORK MANAGEMENT TRIBUTARY STATE 



SYSTEM LINE TABLE ( EXTENSION ) 

THIS TABLE IS INDEXED BY SYSTEM LINE NUMBER AND 

ASSOCIATES EACH SYSTEM LINE WITH AN LLC PROCESS 
AND A CHANNEL NUMBER WITHIN THAT PROCESS.. 



000040 
000040 



ILuCTB: 



.BYTE i»6 * (A) $ SLNOt CHANNEL jLLC 

NO TRIBUTARIES IN THIS CONFIGURATION 



PROCESS DESCRIPTOR VECTOR OFFSETS AND BIT DEFINITIONS 



000000 
000002 

000004 
000006 
00000? 
000010 

000014 

000016 
000020 



000016 



000000 
000001 
000002 
000004 
000010 
000020 



z.dsp: 


.BLKW 1 




.BLKW 1 


z . nam : 


.BLKW 1 


z.lln: 


. BLKB 1 


z.sch: 


.BLKB 1 


Z.flg: 


.BLKW 1 


7. pcs: 


.at_Ku t 


Z.awl: 


.BLKW 1 


Z.LEN» 


.-Z.DSP 


z.dat: 


.BLKW 1 


z.map: 




i FLAGS 


WORD BIT 


ZF.X3P" 





ZF.DDH- 


1 


ZF.DLC" 


2 


ZF.LLC* 


4 


ZF.MFL" 


10 


ZF.KHX* 


20 



RELOCATION BIAS OF DISPATCH TABLE 
VIRTUAL ADDRESS OF DISPATCH TABLE 

PROCESS NAME (RAD50) 

* OF LOGICAL LINES (LLC'S ONLY) 

PROCESS PRIORITY (COMPLEMENT) 

FLAGS WORD 

PCS OF LQADEI) PROCESS PARTITION 

POINTER TO FIRST FREE BLOCK IN PROCESS SPACE 

LENGTH OF PDV 

BIAS OF LLC DATA BASE 

DISPLACEMENT OF LLC MAPPING TABLE 



PROCESS REQUIRES PARAMETERS FROM X3P*DF MACRO 

PROCESS IS A DDM 

PROCESS IS A DLC 

PROCESS IS A LLC 

PROCESS IS MARKED FOR LOAD ( WITH NS ) 

PROCESS IS A DDM FOR A KMC DEVICE 
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000040 
000100 
000200 
000400 

001000 
002000 
004000 
010000 
020000 
040000 
100000 



100000 
140000 



ZF.MUX* 40 i PROCESS IS A DDH FOR A MULTIPLEXER DEVICE 

ZF.LNC« 100 t PROCESS REQUIRES MICRO-CODE TO BE LOAOED 

ZF.TIM* 200 J PROCESS REQUESTS TIMER SUPPORT 

ZF.NTM- 400 i PROCESS REQUIRES TIMER ENTRY ON EVERY ACTIVE PROCESSOtt 

» (8SX-11M+ MULTI-PROCESSOR SYSTEMS ONLY) 

ZF.COU-1000 ; LLC/DLC PROCESS SUPPORTS COUNTERS 

ZF.PSE«2000 i PROCESS IS A PSEUDO ODM/DLC 

ZF.OIA-4000 J PROCESS REQUIRES DIAGNOSTICS MICRO-CODE LOAD 

ZF.SLI-10000 r PROCESS SUPPORTS SYSTEM LEVEL INTERFACE 

ZF.MAN»20000 » PROCESS SUPPORTS NETWORK MANAGEMENT REQUESTS 

ZF.INI»40000 i PROCESS SUPPORTS INITIALIZATION AND TERMINATE 

ZF.DVP-100000 » PROCESS ALWAYS RUNS AT IT'S PRIORITY 

CHANNEL TABLE FLAGS 



ZS.ASN-100000 
ZS.BSY«140000 



t CHANNEL IS FREE TO ASSIGN 

> CHANNEL IS IN PROCESS OF ASSIGNMENT 



AUX - PROCESS DESCRIPTOR VECTOR • 



THIS IS AN LLC PROCESS 



000042 




000042 


000000 


000044 


000000 


000046 


004640 


000050 


000 


000031 


340 


000052 


000614 


000034 


000000 


000034 


000000 


000040 


000000 



auxpdv: 



000062 




000062 


000000 


000064 


000000 


000066 


021274 


000070 


000 


000071 


340 


000072 


000214 


000074 


000000 


000076 


000000 


000100 


oooooo 



000102 

000102 OOOOOO 

000104 OOOOOO 

000106 017704 



evlpdv: 



ECLPDV! 



.WORD 





; (i) > 


.UORD 





» (i) i 


.RAD50 


t'AUX/ 


i (D) ) 


.BYTE 





J (R) r 


.BYTE 


"C <PRO; IPR7 




.UORD 


614 


; (D> ; 


.WORD 





> <i> ; 


■ UORD 





i (R> i 


.UORD 





; (i) } 



RELOCATION BIAS 

DISPATCH TABLE ADDRESS 

PROCESS NAME 

AVAILABLE BYTE 

f (A) > PRIORITY 

FLAG UORD 

LOADED PROCESS PCB POINTER 

PROCESS FREE SPACE POINTER 

VIRTUAL ADDRESS OF LLC DATA BASE 



EVL - PROCESS DESCRIPTOR VECTOR * 1 



THIS IS AN LLC PROCESS 



.UORD 





(I) 


.UORD 





. (I) 


.RAD30 


/EVL/ 


(D> 


.BYTE 





t (R> 


.BYTE 


~C<PR0>iPR7 




.UORD 


214 


(D) 


.UORD 





(I) 


.UORD 





(R> 


.UORD 





<I> 



RELOCATION BIAS 

DISPATCH TABLE ADDRESS 

PROCESS NAME 

AVAILABLE BYTE 

i (A) i PRIORITY 

FLAG UORD 

LOADED PROCESS PCB POINTER 

PROCESS FREE SPACE POINTER 

VIRTUAL ADDRESS OF LLC DATA BASE 



ECL - PROCESS DESCRIPTOR VECTOR * 2 



THIS IS AN LLC PROCESS 



.UORD 
.UORD 



.RAD50 /ECL/ 



(I) 

<I> 



RELOCATION BIAS 
DISPATCH TABLE ADDRESS 



(D) i PROCESS NAME 
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MACRO V03.00 U*4n**d«* l4-0*c-33 10:43 Pa** 3-4 



000110 


000 


000111 


340 


000112 


001214 


000114 


000000 


000116 


000000 


000120 


000000 



000172 
000172 
000174 
000176 
000200 
000201 
000202 
000204 
000206 



000000 
000000 

015413 
000 
100 
021003 
000000 
000000 
000001 



000122 






000122 


000000 




000124 


000000 




000126 


114224 




000130 


002 




000131 


340 




000132 


001214 




000134 


000000 




000136 


000000 




000140 


000000 




000142 


000 


300 


000144 


000 


000 



000146 






000146 


000000 




000130 


000000 




000152 


015370 




000134 


002 




000135 


340 




000156 


000214 




000160 


000000 




000162 


000000 




000164 


000000 




000166 


000 


300 


000170 


000 


200 



BYTE 





(R) 


BYTE 


~C<PR0>»PR7 




UORD 


1214 


(0) 


WORD 





(I) 


UORD 





(R) 


UORD 





<I> 



AVAILABLE BYTE 

i (A) ! PRIORITY 

FLAG WORD 

LOADED PROCESS PCB POINTER 

PROCESS FREE SPACE POINTER 

VIRTUAL ADDRESS OF LLC DATA BASE 



XPT - PROCESS DESCRIPTOR VECTOR ♦ 3 
THIS IS AN LLC PROCESS 



xptpdv:: 






.UORD 





(I) 


.UORD 





<I> 


.RAD50 


/XPT/ 


CD) 


.BYTE 


-> . 


(A) 


.BYTE 


"C<PR0>1PR7 




.UORD 


1214 


<D> 


.UORD 





(I) 


.UORD 





<R) 


.UORD 





(I) 


.BYTE 


Of 300 


(A) 


.BYTE 


0.0 


(A) 



RELOCATION BIAS 

DISPATCH TABLE ADDRESS 

PROCESS NAME 

NUMBER OF CHANNELS ALLOCATED FOR XP1 

t <A) i PRIORITY 

FLAG WORD 

LOADED PROCESS PCB POINTER 

PROCESS FREE SPACE POINTER 

VIRTUAL ADDRESS OF LLC DATA BASE 

CHANNEL 0: RESERVED FOR LQOP&ACK 

CHANNEL i: 3LN0. TRIBUTARY 



PROCESS DESCRIPTOR VECTOR » 4 



THIS IS AN LLC PROCESS 



DLXPDv: : 






.UORD 





(I) 


.UORD 





( T } 


.RA050 


/DLX/ 


'.D> 


.BYTE 


^ 


t (A) 


.BYTE 


-C.PR0>IPR7 




.UORD 


214 


, <D) 


.UORD 





(I) 


-UORD 





(R) 


.UORD 





(I) 


.BYTE 


0,300 


<A> 


.BYTE 


0.200 


(A) 



PROCESS DESCRIPTOR VECTOR 
THIS IS A DON PROCESS 



RELOCATION BIAS 

DISPATCH TABLE ADDRESS 

PROCESS NAME 

NUMBER OF CHANNELS ALLOCATED FOR DLX 

i (A) » PRIORITY 

FLAG UORD 

LOADED PROCESS PCB POINTER 

PROCESS FREE SPACE POINTER 

VIRTUAL ADDRESS OF LLC DATA BASE 

CHANNEL 0: RESERVED FOR LOOP&ACK 

CHANNEL i: UNASSIGNED 

* 5 



DMCPDV: 










.UORD 





(I) 




.UORD 





(I) 




.RADSO 


/OMC/ 


<D> 




.BYTE 





CR) 




.BYTE 


"CPR3>tPR7 






.UORD 


21003 


<D> 




.UORD 





(I) 




.UORD 





(R) 




.END 







RELOCATION BIAS 

DISPATCH TABLE ADDRESS 

PROCESS NAME 

AVAILABLE BYTE 

; (A) i PRIORITY 3 

FLAG UORD 

LOADED PROCESS PCB POINTER 

PROCESS FREE SPACE POINTER 
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CETA8 


MACRO V03 


00 u»<jn*«dai 


i !4-D«c-83 


10:43 P«i» 3-3 










3*»OOl 


tael* 


















aux > 


• 000000 


ECLNXT- 


> 000001 


LN.STA" 000017 


P»«LAS« 


1 OOOOOO 


SOCN . 


■ OOOOOO 


AUXCHN« 


■ 000000 


ECLPDV 


000102RG 


002 LN.SUB* 000360 


PttLQL 


> 001130 


SODO 


' 000003 


AUXFL ' 


• 000614 


ECLPR > 


, oooooo 


LN.TRI- 000004 


P»»OFFi 


■ OOOOOO 


SODL ' 


• 000005 


AUXNXT< 


■ 000001 


eve 


• 000001 


L»»ASG" OOOOOO 


P«SP43< 


. OOOOOO 


SOU. ' 


■ 000003 


AUXPDV 


000042RG 


002 EVLCHN" 


• oooooo 


Lt»ofty- oooooo 


PffftFU 


1 oooooo 


SOPO > 


■ 000006 


AUXPR 


■ oooooo 


EVLFL 


• 000214 


Lt»LDR 


■ OOOOOO 


P««RTY> 


■ oooooo 


SOSF 


• C06010 


A»*8I0> 


' oooooo 


EVWNXT> 


■ 000001 


L»«PTO« 000036 


P««SRF< 


• oooooo 


SOTY 


■ 000001 


A*«BRT> 


> oooooo 


EVLPDV 


000062RG 


002 U.COST 


000013 


Q««NGR 


• oooooo 


SOUN 


' OOOOOO 


A*tCHK' 


■ oooooo 


EVLPR ■ 


, oooooo 


L.CTL 


000012 


Qt«OPTi 


• 000003 


TR 


• 000002 


A*»CLI' 


■ ooooos 


EXITUM< 


> 000001 


L.DDM 


000002 


RD8.NB> 


• 000011 


TStACft' 


• oooooo 


A*«CP5" 


• oooooo 


E*»OVC> 


■ oooooo 


L.DDS 


000004 


RDB.S2' 


' 001100 


TttBTU< 


• oooooo 


A»*NSI" 


• oooooo 


£t*U06> 


■ oooooo 


L.DLC 


000003 


R»«exv< 


• oooooo 


TitBUF" 


. oooooo 


A»«PRI" 


■ oooooo 


EMXPRi 


> oooooo 


L.DLH 


000006 


R««(.KL> 


■ 00000 I 


T»«CCAi 


. oooooo 


A»STRP' 


■ oooooo 


F»«LPP 


■ oooooo 


L.OLS 


000010 


R»»CU 


• 000001 


T»«CCO' 


■ oooooo 


B««LV1« 


032443 


F*«LVL« 


000001 


L.FLG 


OOOOOO 


R««NDC< 


000003 


T**CPW« 


■ oooooo 


8«»l.V2' 


■ 020040 


G»«EFNi 


■ oooooo 


L.KRBA 


000016 


R**NDH> 


• 000226 


T*«CTRi 


« oooooo 


CCB.N8« 


> 000010 


G««TPP« 


■ oooooo 


L.LEN - 000022 


RStNDL- 


> 000001 


Tt»CUP" 


■ oooooo 


CCB.S2' 


■ 000044 


G«»TSS« 


■ oooooo 


L.rtPF 


000022 


R*«POI< 


. oooooo 


T«»ESC' 


■ oooooo 


CHAN • 


> 0OOOO1 


G»*TTKi 


> oooooo 


L.NHST 


000020 


fit»»SND« 


• oooooo 


T»»G«C" 


1 oooooo 


CNT > 


■ 000031 


H«*RT2i 


■ 000074 


L.NSTA 


000014 


R»*TPR» 


• 032063 


T*»GTS> 


■ oooooo 


CNTLR « 


, oooooo 


If tRARi 


■ oooooo 


L.OUNR 


000021 


R««11N< 


. oooooo 


T«»HFF 


■ oooooo 


CT6NUH> 


• oooooo 


I»«RDN« 


■ oooooo 


L.UNT 


000013 


SOB.NB< 


• 000013 


TttHUO' 


• OOOOOO 


C«»CBA« 


■ 000007 


K*tAST> 


■ oooooo 


MASTER' 


■ 177777 


SDB.S2' 


■ 000042 


Tt»KMG' 


» oooooo 


C»«CKP> 


■ 000004 


KttCNT 


i 177344 


N«»CRB 


■ 000124 


SF.ACT 


• 000200 


T«»LUC 


■ oooooo 


C»»CSR» 


■ 174400 


K»*CSR« 


■ 177344 


N«»CRX» 


. oooooo 


SF.ENA. 


• 000100 


T»»REB> 


■ oooooo 


C»«INT> 


. oooooo 


K««IEN< 


• 000113 


H«*£IS 


• OOOOOO 


SF.LPB< 


• 000004 


r$»RN£ 


• oooooo 


C*«ONS' 


■ 000001 


K«»LDC> 


■ 000001 


««*FC3' 


• OOOOOO 


SF.MFL" 


• 000040 


T*«RPRi 


■ oooooo 


C**ORE> 


■ 002022 


K»«TPS- 


■ 000074 


n«»riGE 


■ oooooo 


SF.PAC 


• 000020 


T««RST 


■ oooooo 


C*«RSH« 


■ 177364 


UO»CO " 


> OOOOOO 


«»*«UP" 


■ oooooo 


SF.REA" 


■ 000010 


T*»RUB" 


■ oooooo 


C*»RUN« 


■ 000001 


LOtOL 


. OOOOOO 


HtfMET 


■ oooooo 


SF.5ER 


• 000001 


TttSNC' 


. oooooo 


C*«SMT« 


» OOOOOO 


LD«TT " 


oooooo 


rt»»OVR> 


■ oooooo 


SF.3VC" 


■ 000002 


T**SYN> 


■ oooooo 


C»*TTY« 


■ 1773o4 


LF.ACT 


■ 100000 


NONE 


■' 177777 


SF.UNL 


■ 000040 


TttTRyi 


■ oooooo 


DLX 


■ 000004 


LF.BRQ" 


000400 


N««LDU< 


• 000001 


SLAVE • 


, oooooo 


T»«UTB" 


> oooooo 


DLJCCHN" 


■ 000001 


LF.8UT 


■ 000007 


NtfrtOV 


• 000041 


SLINE 


■ 000001 


T«»UTO< 


■ 000170 


QLXFL • 


■ 000214 


LF.ENA« 


• 002000 


PDN 


• OOOOOS 


SLN 


. oooooo 


T«fVBF« 


• OOOOOO 


DLXNXT" 


• 000001 


LF.LPB" 


■ 001000 


PDVNH 


• 000010 


SLTTOT- 


• 000001 G 


T«»30P« 


• oooooo 


DLXPDV 


000146RG 


002 LF.MDC' 


• 000100 


PDVTOT< 


' 000004 G 


SLTO 


000016R 


002 UNT 


■ OOOOOO 


OLXPR i 


« OOOOOO 


LF.HFL 


• 004000 


POtAUX 


. OOOOOO G 


SSLO 


■ OOOOOO 


V««CTR' 


' 000604 


DnC 


■ 000003 


LF.rtTP" 


■ 000020 


PD*OLX» 


> 000010 G 


STATBt" 


■ oooooo 


V*tRSN> 


■ 000041 


DHCFL ' 


■ 021003 


LF.PAC 


■ 000200 


PDtDMC 


• 0QOO12 G 


STATN > 


. OOOOOO 


XPT 


■ 000003 


DMCMXC" 


. OOOOOO 


LF.RDYi 


• 040000 


FD«ECL« 


• 000004 G 


S»»HFC" 


> 000036 


XPTCHN" 


■ 000001 


DttCPDV 


0001 72RG 


002 UF.REA" 


• 010000 


PDtEVL' 


• 000002 G 


S(«N(11> 


» 044332 


XPTFL > 


■ 001214 


rmcpft > 


> 000005 


LF.SER- 


000040 


PDfXPT" 


• 000006 G 


S»«NM2« 


041522 


XPTNXT" 


000002 


OMCOA > 


> 000001 


LF.UH" 


• 000010 


POINT ■ 


» 000001 


S**NN3> 


> 047117 


XPTPOV 


000122RG 


D»*IAG> 


OOOOOO 


LF.UML' 


020000 


PRO « 


OOOOOO 


S»«TIM> 


OOOOOO 


XPTPR > 


oooooo 


D»»ISK« 


• OOOOOO . 


LF.X2P' 


■ oooooo 


PR1 


> 000040 


S*«TOP> 


■ OOOOOO 


2F.C0U" 


• 001000 


D*»L11" 


> 000002 


LN.CLQ" 


oooooo 


PR2 " 


> 000100 


S**Ut.K> 


oooooo 


2F.DDM" 


000001 


D«»PAR> 


• OOOOOO 


LN.&UN' 


■ 000003 


PR3 


■ 000140 


S«»UPC< 


• 000036 


2F.DIA. 


1 004000 


[i*«SHF» 


■ OOOOOO 


LN.LOAi 


000004 


FR4 


■ 000200 


S*«UPR« 


000003 


2F.0LC" 


> 000002 


D*»yCK> 


■ OOOOOO 


UN. LOO" 


■ 000003 


PR3 


> 000240 


S«»UST< 


1 oooooo 


ZF.yjp 


, 100000 


D*»YNC> 


• OOOOOO 


LN.OAU" 


000003 


PR6 « 


■ 000300 


SStYSZ" 


007600 


2F.INI- 


1 040000 


D»*YNH» 


■ oooooo 


LN.OFF. 


» 000001 


PR7 


■ 000340 


S.COST 


000001 


ZF.KrtX" 


■ 0000:0 


D»»2rtD« 


■ OOOOOO 


LN.ON > 


. oooooo 


P»«BPR> 


> 000063 


S.FLG 


oooooo 


2F.LLC" 


ooooo* 


D*»211> 


. 000001 


LN.OOP' 


■ 000004 


P«tCTU 


■ OOOOOO 


S.LEN 


000004 


ZF.LrtCi 


■ 000 I 00 


ECL 


« 000002 


LN.OPE" 


000001 


P*»FRS« 


■ 000310 


S.NrtST 


000002 


2F.MAN" 


0:0000 


ECLCHNi 


oooooo 


LN.REF" 


> 000002 


P**GMX> 


. OOOOOO 


3.0UNR 


000003 


2F.ttFL> 


« 000010 


ECIFL ' 


> 001214 


LN.SER" 


000002 


Pt«HIL> 


■ 003100 


SOCH « 


00OOO1 


2F.MTM" 


■ 000400 
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DECnet-RSX INSTALLATION AND CHECKOUT 



CSTAB MACRO yos 


,00 


a»drs««dss 14-0ae-e3 10! 


143 ! 


»SS9 


3-6 


S»at>ol tablt 












ZF.MUX» 000040 




ZS.ASN* 100000 


Z, 


.FLG 


000010 


ZF.PSE" 002000 




ZS.SSY- 140000 


z 


.LEN 


« 000016 


ZF.SLI* 010000 




Z.AVL 000014 


z, 


.LLN 


000006 


ZF.TIM" 000200 




Z.DAT 000016 


z 


.HAP 


000020 


ZF.X3P* 000000 




Z.DSP 000000 


z, 


.NAM 


000004 


. ABS. 000022 


000 


crw>:>gbl>a&SfOvr) 








000000 


001 


CRW. I#LC!..R£L»CON) 








CEXCOrl 000210 


002 


(RUf Itl.Cl.»ftELiCON) 








Error* detected: 














Z.PCB 000012 
Z.SCH 000007 
»0S1 « 000000 
*DT1 » 000000 
H.LCTB 000040RG 



tPDVND 000014RG oo: 

♦POVTB oooooorg oo: 

«SLTMB 000014RG 00: 

•SLTND 000040RG 00: 

002 tSLTTB 000016RG 00: 



%%% Ass**ol«r statistic* 



Work fil* reads: 26 

Work flit writt*: 31 

Si=» of work filt: 20695 Words < 31 Pasts) 

Si:» of con pool: 20466 Words ( 78 Pasts) 

Otratins syste*: ftSX-UM/PLUS 



Elapstd tia«: 00:01:14.01 

0U:C300.241CETAB.LS:C3OO»34 3CETAB.LST/-SP-IN:C13O.lO3NETLIB/r}L»0U:C3OO>01O3RSXrlC.C30Of543CETAB 
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DECnet-RSX INSTALLATION AND CHECKOUT 



;PAR 












CEXPAR 


111734 


112000 


006000 


MAIN 


COM 


EXC0M1 


111670 


120000 


014700 


MAIN 


COM 


EXC0M2 


111624 


134700 


010200 


MAIN 


COM 


LDRPAR 


111560 


145100 


002600 


MAIN 


TASK 


TTPAR 


111214 


147700 


040000 


MAIN 


TASK 


DRVPAR 


110670 


207700 


002300 


MAIN 


SYS 




110624 


207700 


002100 


SUB 


DRIVER -DL 




110524 


212000 


000200 


SUB 


DRIVER -CO 


SYSPAR 


110460 


212200 


010100 


MAIN 


TASK 


FCSRES 


110414 


222300 


032000 


MAIN 


COM 


FCr-RAR 


110250 


254300 


024200 


MAIN 


SYS 




034374 


254300 


024200 


SUB 


(F11ACP) 


GEN 


110304 


300500 


457300 


MAIN 


SYS 




034264 


300500 


006300 


SUB 


(PMT...) 




044400 


321700 


023200 


SUB 


(NETACP) 




035000 


345100 


020000 


SUB 


( . . .MCR) 




034454 


407000 


027200 


SUB 


(RMDEMO) 


NT.DMC 


046634 


663700 


003400 


SUB 


DYNAMIC 


NT.DLX 


046524 


667300 


011100 


SUB 


DYNAMIC 


NT.XPT 


046570 


700400 


010500 


SUB 


DYNAMIC 


NT.ECL 


036734 


711100 


016000 


SUB 


DYNAMIC 


NT.EVL 


045020 


727100 


003000 


SUB 


DYNAMIC 


NT.AUX 


045314 


732100 


002700 


SUB 


DYNAMIC 


POOL.. 


041744 


735000 


020200 


SUB 


DYNAMIC 




035150 


755200 


001700 


SUB 


DRIVER -HT 




040330 


757100 


000700 


SUB 


DRIVER -NM 
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T\T\ 



>TAS 














LDft... 


13.02 


LDRPAR 


248. 


002600 


LBO 


-00012306 FIXED 


TKTN 


03.00 


SYSPAR 


248. 


010100 


LBO 


5-00016376 


.. .RMD 


2.00 


GEN 


223. 


027200 


LBO 


.-00017Q37 


RMDEMO 


2.00 


GEN 


223 . 


027200 


LBO 


: -00017037 


FilHSG 


13.00 


GEN 


200. 


005700 


LBO 


, -00013422 


rtTAACP 


14.00 


GEN 


200. 


014700 


LBO 


5-00016711 


NETACP 


v04 . 00 


GEN 


200 . 


Ci J<i w 


r. i /\ 




EMC. 


V04.0Q 


GEN 


193. 


027600 


DLO 


t-00022636 CHECKPOINTED 


EVR*** 


(J04.00 


GEN 


1??. 


027300 


DLO 


5 -00011221 


. ..DMQ 


04.00 


GEN 


160. 


014600 


LBO 


! -00014446 


NCR... 


4.00 


SYSPAR 


160. 


010100 


LBO 


.-00013264 


...DCL 


2.0 


GEN 


160. 


040000 


LBO 


: -00015671 


...MOU 


26.00 


GEN 


160. 


037700 


LBO 


-00015310 


...MCR 


2.01 


GEN 


160. 


020000 


LBO 


5-00015305 


NVP. . . 


V04.00 


GEN 


150. 


012700 


DLO 


-00011302 


F11ACP 


OS. 00 


FCPPAR 


149. 


024200 


LBO 


5-00014542 


ERRLOG 


2.00 


GEN 


148. 


040000 


LBO, 


-00017506 


PMT.. . 


2.00 


GEN 


148. 


006300 


LBO 


5-00015242 


COT... 


2.0 


GEN 


143. 


013300 


LBO 


.-00014465 


PHD. .. 


08.00 


GEN 


140. 


015700 


LBO 


: -00016661 


SHF. . . 


6.00 


SYSPAR 


103. 


010100 


LBO 


-00017176 


.. .INS 


3.00 


GEN 


100. 


034300 


LBO 


: -00014750 


. . .SAV 


04.00 


GEN 


100. 


033100 


LBO 


-00016550 


...UfB 


05.00 


GEN 


100. 


003700 


LBO 


5-00015470 


. , .BAD 


04.00 


GEN 


100. 


070000 


LBO 


5-00017573 


...S£N 


12AUG 


GEN 


100, 


104500 


SYO 


5-00035431 


MAL*** 


11RX 


GEN 


ioo. 


132300 


SYO 


.-00036333 


NMVACP 


V04.00 


GEN 


100. 


027200 


DLO 


5-00025673 


LIN*** 


V04.00 


GEN 


100. 


010300 


DLO 


-00011367 


LQ04S* 


yo4.oo 


GEN 


100. 


022300 


DLO 


.-00011170 


FAL. .. 


V05.00 


GEN 


100. 


143600 


DLO 


' -00011500 


RrtHACP 


yo4.oo 


GEN 


100. 


023300 


DLO 


5-00011724 


LSN*** 


V04.00 


GEN 


100. 


020300 


DLO 


-000134 73 


RMTACP 


yo4»oo 


GEN 


99. 


027700 


DLO 


-0001 1633 


QttG. . . 


03.00 


GEN 


75. 


031400 


LBO 


-00015366 


PRT.. . 


2.0 


GEN 


70. 


001100 


LBO 


5-00012723 


LPO 


03.00 . 


GEN 


70. 


014200 


LBO 


-00016447 


; _ .ire 


3 i 00 


GEM 


70 i 


rtrtiJAft 


LBO 


>_rtAA^7477 


. . .BRU 


5.31 


GEN 


70. 


173700 


LBO 


-00027377 


.. .EST 


02.00 


GEN 


63. 


130700 


LBO 


5-00032531 


. . .MAI 


24FEB 


GEN 


63. 


137300 


SYO 


-00035671 


. ..AT. 


6.0 


GEN 


64. 


060000 


LBO 


5 -00015076 


NTL... 


V04.00 


GEN 


60. 


037500 


DLO 


-00026152 


NTINIT 


V04.00 


GEN 


S3. 


006600 


DLO 


-00002374 


...3UE 


03.00 


GEN 


50. 


020100 


LBO 


-00016277 


. . .PS I 


03.00 


GEN 


50. 


020100 


LBO 


-00016277 


., .BOO 


06.02 


GEN 


50. 


021700 


LBO 


-00012662 


...£_I 


1.00 


GEN 


50. 


017000 


LBO 


-00017552 


. . .ftAG 


02.00 


GEN 


50. 


031500 


LBO 


-00015434 


. . .L3A 


4.0 


GEN 


50. 


032300 


LBO 


-00016406 


.. .H£L 


2.00 


GEN 


50, 


023500 


LBO 


-00017355 


. . . r ■ t E 


03.00 


GEN 


50. 


012600 


LBO 


-00017314 


...1=0 


03.00 


GEN 


50. 


030300 


LBO 


-00017420 


. . .L-nL 


4.0 


GEN 


50. 


024500 


LBO 


-00016632 


. . .PIP 


16.00 


GEN 


50. 


040000 


LBO 


-00004732 


. . .MAC 


V05.00 


GEN 


50. 


070000 


LBO 


-00004356 


. . .TKB 


M40. 10 


GEN 


30. 


070000 


LBO 


-00005123 


MAI 


300CT 


GEN 


50. 


037700 


SYO 


5-00036126 


. . .r<CP 


Y04.00 


GEN 


50. 


064'400 


DLO 


-00025237 


N I C i * « 


V04.00 


GEN 


30. 


007600 


DLO 


.-00004207 


. . .NTB 


V03.00 


GEN 


50. 


037700 


DLO 


-00010760 



Example 7 Tasks (Sheet 1 of 2) 
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DECnet-RSX INSTALLATION AND CHECKOUT 



NTD... V03.00 GEN SO. 030200 DLO : -0001 1022 

MIR1S* V04.00 GEN 50. 001600 DLO ! -0001 1213 

...NFT V04.00 GEN 50. 063000 DLO: -00013662 

.CUTS. V04.00 GEN 50. 002100 DL05 -00011333 

...RttT V04.00 GEN 50. 002100 DLO : -000,1 1646 

...TLK V04.00 GEN 30. 042700 DLO *. -00013334 

TCL... Y04.00 GEN 30. 002300 DLO : -0001 1765 

...LBR 07.00 GEN 30. 040000 LBO 5 -00004246 



Example 7 Tasks (Sheet 2 of 2) 
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DECnet-RSX INSTALLATION AND CHECKOUT 



>DEV 


DLO 


Public Mounted Loaded Label*RSXM33 T**e=RL02 


DL1 


Loaded T*pe»RLQ2 


COO 


tto: 


HTO 


' Offline Loaded 


HT1 


Offline Loaded 


HT2 


Offline Loaded 


HT3 


Offline Loaded 


NttO 


Loaded 


NSO 




NXO 


Public Loaded 


TTO 


C5>13 - Losaed in Loaded 


TT1 


Loaded 


TT2' 


Loaded 


TT3 


Loaded 


TT4S 


Loaded 


tt; 


Loaded 


TT6. 


Loaded 


7 i / 


Loaded 


TT1C 


>i Loaded 


TTU 

Ml ft 


: Loaded 


TIO! 




CLOS 


TTOi 


lbo: 


dlo: 


SY05 


dlo: 



Example 8 Devices 
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DECnet-RSX INSTALLATION AND CHECKOUT 



EXERCISES 

Match the network components to the appropriate functions. 
Each item may be used once, more than once, or not at all. 

Responsible for loading the network 
software into core. 

Provides direct line access interface. 

Updates the Routing database on 
routing nodes. 

Manages the DECnet software. 

Receives the network events from 
remote nodes. 

User interface for the logical link. 

User interface for the network 
management. 

DDCMP software process. 

Interface between the Routing and 
PLI. 

X. 25 Level 3 protocol software. 
X. 25 Level 2 protocol software. 



1. 


CEX 

NCP 

KMCL 

NSDRV 

EVL 

RCP 

NTL 

PLI 

NETACP 

DLX 

LAB 

NT IN IT 

EVC 

DLM 


a. 


2. 


b. 


3. 


c. 


4. 
5. 


d. 


6. 


e. 


7. 


f . 


8. 


g. 


9. 

10. 


h. 


11. 


i . 


12. 


J- 


12. 


k. 


14. 
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DECnet-RSX INSTALLATION AND CHECKOUT 



SOLUTIONS 

Match the network components to the appropriate functions. 
Each. item may be used once, more than once, or not at all. 

a. .7 Responsible for loading the network 
software into core. 

b. . 10 Provides direct line access interface. 

c. 6 Updates the Routing database on 
routing nodes. 

d. . 1 Manages the DECnet software. 

6. RCP e. 13 Receives the network events from 

remote nodes. 

7. NTL 

8. PLI 



1. 


UiiA 


2. 


NCP 


3e 


MCL 


4. 


NSDRV 


5. 


EVL 



f. 4 User interface for the logical link. 



g. 2 User interface for the network 

9. NETACP management. 

10. DLX h. none DDCMP software process. 

11. LAB i . 14 interface between the Routing and 

PLI. 

12. NTINIT 

j. 8 X. 25 Level 3 protocol software. 
12. EVC 

k. 11 X. 25 Level 2 protocol software. 
14. DLM 
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DECnet-RSX INSTALLATION AND CHECKOUT 



LAB EXERCISES 

1. Given a network configuration, perform NETGEN on a designated 
system. 

2. Run the NTEST procedure for: 

• Local node 

• Remote node 

• Loopback node 
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DECnet-RSX INSTALLATION AND CHECKOUT 

SOLUTIONS TO LAB EXERCISES 

1. See NETGEN Example 2 
■2. See NTEST Example 4 
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DECnet-RSX ADDITIONAL NETWORK CAPABILITIES 

INTRODUCTION 

This module covers the following areas: 

• Down-line system loading/up-line dumping 

• Down-line task loading/up-line checkpointing 

• Multipoint 

• Ethernet 

These facilities are provided in the communication hardware 

(down-line system loading/up-line dumping, multipoint, and 

Ethernet) as well as in the software. Both software and hardware 
arrangements are discussed in detail. 

To down-line system load we must assume that DECnet is running 
on the host computer, and there is no operating system running on 
the satellite. To achieve a successful completion of the loading 
of the 0/S we utilize the Maintenance Operations Protocol (MOP). 
The MOP protocol, which is a subset of DDCMP, allows the system 
satellite to be loaded with the 0/S and also allows up-line 
dumping of memory in the event of system failure. 

On the other hand, down-line task loading/up-line 
checkpointing assures that the satellite as well as the host has 
DECnet software running. This facility is implemented as a 
logical link between the Host Loader (HLD) and the Satellite 
Loader (SLD) tasks. 

Multipoint allows more than two computers to share a physical 
line. Polling or time-sharing algorithms are used to identify the 
node that controls the line at a given time. 

Ethernet is a local area network specification developed by 
Xerox Corporation, Digital Equipment Corporation, and Intel 
Corporation to provide high-speed exchange of data within a 
moderate sized geographic area. 



DECnet-RSX ADDITIONAL NETWORK CAPABILITIES 

OBJECTIVES 

Upon completion of this module, the specialist should be able 



to: 



• List the down-line system loading considerations for a host 
and a satellite. 

• Identify the requirements for performing down-line task 
loading/up-line characteristics. 

• Create/update DLL and HLD databases using standard 
installation procedures. 

• List the hardware requirements for down-line system loading 
(multipoint and Ethernet) . 

• Explain the basics of polling algorithm and set the 
corresponding parameters using NCP commands. 

• Demonstrate down-line system loading using generated 
systems. 

• Demonstrate down-line task loading using generated systems. 



RESOURCES 

1. DNA: MOP Protocol Functional Specification 

2. DECnet-RSX System Manager's Guide 

3. DECnet-RSX Network Installation Guide 

4. M9301-YJ Bootstrap Technical Manual 

5. M9312 Technical Manual 

6. DIGITAL Ethernet Products and Services 
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SYSTEM DOWN-LINE LOAD 

An RSX-11S system image can be down-line loaded. Before 
attempting to down-line load, you must ensure that nodes f lines f 
and circuits meet the following requirements: 

• The target node must be connected (Hrectlv^ tg_ the executor 
"node." ™THe~ ""executor""' "node provides the line and 

circuit-level access. 

• The j>rjjnary_ loader must be a cooperating program either in 

tTie" target _..ox^^' n ^^ : ^SSIZ!W^croco6e of the target' s device 

TTDMCTMr/DMP r E^IV or UNA). The down- line load operation 
usually involves loading a series of bootstraps; each 
requests the next program until the operating system itself 
is loaded. 

• To allow the tertiary loader to complete the load sequence , 
the-_JRS X- IIS system image i tself „ mus t be 2K words less than 
the total memory on the target system. _ 

• The^ execu tor must have. access to the load_ files.. The 

location of the files either can be specified in the load 
request or can be a default in the volatile database, 



• 



• 



T he tar get node mus t be abl e__ to r e cg^niz e _ the_.....„t r igge r 

messane or mTrsT^Tvp" f rinnaraH ipariuallv. 

The_oJ^c]^J:__ijx^J2^^6 in the load pper^Jt.ijDn_mujsJ:__bs_... enable,cL 

tp_gerJEorjn. se-r~vi.ce. functions, it must also be in the ON or 

SERVICE state. 
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Table 1 System Down-Line Loading 



Host 



Satellite 



Enter MOP Mode - Only if a 
communications device 
on the satellite can be 
triggered ( DMC/DMR/DMP/DMV/UNA/QNA) 



Memory loaded with XFER ADDR^T 
(entire secondary boot) 



Memory loaded without XFER ADDR^- 
(first segment of tertiary boot) 



Memory load with XFER ADDR _ 
(Last segment of tertiary boot) 



«e£r 



Memory load without XFER ADDR 

(first segment of operating system). „ 



Request program - All 
communication devices 
_( secondary boot) 

"^Request program 
(tertiary boot) 



Request memory load 
(next segment) 



Request program 
„( operating system) 



„_J2> 



Request memory load 
(next segment) 



Parameter load with XFER ADDR 



Request memory load 
(dummy/ACK) 

-Load Complete- 
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Down-Line Loading on DECnet-RSX 

Table 2 Target Initiated Load on DECnet 



Host 



Target 



2. 



Circuit could be in either 
ON, or SERVICE state. XPT 
detects the message and 
activates LIN$$$. LIN$$$ 
gives circuit to DLX 
interface and calls DLL$$$. 
By now the MOP 8 message is 
lost. LIN$$$ sends the MOP 12 
message (MOP mode running) . 



(MOP 12, MOP mode running) 



4. This time DLL$$$ is ready 

to process the MOP 8 message. 
It uses its database to 
identify secondary loader 
for that particular circuit 
and sends it to the target, 

(MOP 0, send entire secondary boot) 



Jjoor j 



The primary bootstrap is 
triggered in one of the 
many possible ways (ROM or 
loaded into core via 
tapes, etc.). The MOP 8 
message will be sent. 



(MOP 8, request secondary boot) 



3. The target node treats 

this as a bad message and 
retransmits the MOP 8 
message. 

(MOP 8, request secondary boot) 



5. The secondary boot assumes 
unmapped system and requests 
tertiary boot. 

(MOP 8, request tertiary boot) 
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Table 2 Target Initiated Load on DECnet (Cont) 

Host Target 

6. DLL$$$ sends the tertiary 
boot. 

(MOP 2 and MOP 0, more than one transfer) — > 

7. The tertiary boot turns on 
memory management, locates 
itself to top of core, and 
requests the operating 
system. 

< (MOP 8, request operating system) 



8. DLL$$$ sends the operating 
system. In reality, the 
tertiary boot is 2K and 
relocates itself to top 

of memory. Thus only 122KW 
of a 124KW system image can 
be loaded. 

(MOP 2 and MOP 0, transfer RSX-11S) 

9. When load is completed, 
DLL$$$ records event to 
EVL; LIN$$$ reassigns 
the circuit back to XPT 
interface if previously 
owned by XPT. Procedure 
is completed. 
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NOTE 
If the target is attached by using an 
Ethernet cable to the host node, the load 
request passes through the DDM to the 
Ethernet Protocol Manager (EPM) to LIN$$$. 
LIN$$$ then gives the circuit to DLX and 

\b* cl -*r -*- o LJ J— i Jjy y y $ 

Load Initiated by the NCP TRIGGER Command 

NCP activates DLL$$$, that sends a MOP mode message (MOP 6) to 
the DMC/DMR/DMP/DMV/UNA/QNA on the other side. The 
DMC/DMR/DMP/DMV/UNA/QNA responds by activating the bootstrap ROM 
and sends the MOP 8 message to request the secondary boot. From 
this point on, the sequence of events is the same as if the target 
system initiated the sequence. 

Use the TRIGGER command when the target node is an unattended 
system equipped with an appropriate bootstrap ROM. The executor 
for a triggered down-line load is not necessarily the same as the 
node that executed the TRIGGER command. This command triggers the 
bootstrap mechanism of a node so that it loads itself. 

Load Initiated by the NCP LOAD Command 

NCP activates DLL$$$ f which first picks up information from 
the volatile database. If parameters have been specified in the 
LOAD command, these parameters override those in the permanent 
database. The file specification in the "software type" is sent 
first. (The default is secondary boot; if successful, continue.) 
If this fails, the MOP 6 (enter MOP mode) message is sent as in 
the trigger case. From this point on, the sequence of events is 
the same as the NCP TRIGGER command. 

Use the LOAD command when the target's primary bootstrap ROM 

is already running. The node that issues a LOAD command is always 

the executor for the requested down-line load. (Additional 

details on down-line system load hardware arrangements are 
provided in Appendix A.) 
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Host Considerations (for Down-Line System Load) 

Both the permanent and the volatile database can include 
default parameters for down-line loading. 

• Use the CFE DEFINE NODE command to set up the permanent 
database, that is loaded into the volatile database when 
the system is loaded. 

• Use the NCP SET NODE command to establish default 
information for the target node in the volatile database. 

The NCP LOAD and TRIGGER commands default to entries in the 
volatile database when you omit down-line loading parameters. Any 
parameter you specify explicitly in a LOAD or TRIGGER command 
overrides the default. These default parameters are also used for 
target-initiated down-line loads. . 

>NCP 

NCP> SET NODE 258 NAME REMSYS 

NCP> SET NODE REMSYS SERVICE CIRCUIT UNA-0 

NCP> SET NODE REMSYS SERVICE DEVICE UNA 

NCP> SET NODE REMSYS SERVICE VERSION 4 

NCP> SET NODE REMSYS SERVICE PASSWORD 0000000000000000 

NCP> SET NODE REMSYS HARDWARE ADDRESS AA00030100AB 

NCP> SET NODE REMSYS LOAD FILE LB0: [2 , 54] RSX11S . SYS 

NCP> SET NODE REMSYS SECONDARY LOADER LB0 : [ 2 , 54 ] SECUNA. SYS 

NCP> SET NODE REMSYS TERTIARY LOADER LB0: [2 , 54] TERUNA. SYS 

Example 1 Creating a Down-Line System Loading Database 

(Using NCP) 
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>CFE 

Enter filename: 
CFE> DEFINE NODE 
CFE> DEFINE NODE 
CFE> DEFINE NODE 
CFE> DEFINE NODE 
CFE> DEFINE NODE 
CFE> DEFINE NODE 
CFE> DEFINE NODE 
CFE> DEFINE NODE 
CFE> DEFINE NODE 



LBO: [300,54]CETAB.MAC 
258 NAME REMSYS 
REMSYS SERVICE CIRCUIT UNA-Q 
REMSYS SERVICE DEVICE UNA 
REMSYS SERVICE VERSION 4 

REMSYS SERVICE PASSWORD 0000000000000000 
REMSYS HARDWARE ADDRESS AA00030100AB 
REMSYS LOAD FILE LBO: [2 , 54] RSX11S. SYS 
REMSYS SECONDARY LOADER LBO : [2 , 54] SECUNA.SYS 
REMSYS TERTIARY LOADER LBO: [2, 54] TERUNA.SYS 



Mfc 



SZ^S^jTr^-e^- 



Example 2 Creating a Down-Line System Loading Database 

(Using CFE) 



Table 3 Default Loader Files by Device Type 



Device 



Secondary Loader 



Tertiary Loader 



DLV 


SECDLV.SYS 


DL11 


SECDL.SYS 


DMC11 


SECDMC.SYS 


DMP 


SECDMP.SYS 


TMWJTT 

l/ll V 




DPV 


SECDPV.SYS 


DU11 


SECDU.SYS 


DUVll 


SECDUV.SYS 


QNA 


SECQNA.SYS 


UNA 


SECUNA.SYS 



TERDLV.SYS 

TERDL*SYS 

TERDMC.SYS 

TERDMP.SYS 

TERDMV. SYS 

TERDPV.SYS 

TERDU.SYS 

TERDUV.SYS 

TERQNA.SYS 

TERUNA.SYS 



These files are shipped with the DECnet-llS kit. 
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RSX-11S System Down-Line Loading Considerations 

In order to down-line load an RSX-11S node, you must create a 
system image file that is either a DECnet-llS node or a 
stand-alone RSX-11S system (a process control system, for 
example). To create a DECnet-llS node, use VMR and VNP to create 
the system image file. 



>VMR 

Enter f ilename:RSXllS 

VMR> SET /POOL=260 

VMR> SET /MAIN=MCRPAR:260:63:TASK 

VMR> SET /MAIN=CEXPAR:343:41:COM 

VMR> INS BASMCR/FIX=YES 

VMR> INS [xxx,64]NETACP/CKP=NO/FIX=YES 

VMR> INS [xxx,64]NTINIT/FIX=YES 

VMR> <Ctrl Z> 

> 

>VNP 

Enter f ilename:RSXHS 

VNP> SET SYSTEM ALL 

VNP> SET EXECUTOR STATE ON 

VNP> SET LINE DMC-0 ALL 

VNP> SET CIR DMC-0 STATE ON 

VNP> EXIT 

> 

> 



Example 3 Performing VMR and VNP on a RSX-11S System 
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TASK DOWN-LINE LOAD 

Down-line task loading extends nonresident initial load, 
checkpointing, and overlay support to a DECnet-llS node. These 
functions are provided by the SLD on the DECnet-llS node and by 
the HLD on the host DECnet node. The host node in this context is 
determined by the HOST parameter when you down-line load the 
target. Neither SLD or HLD has an operator interface. Once the 
configuration is set up, they operate transparently. 

Control is passed to SLD when an installed task has been 
requested to run (RUN command from a CLI or programmed request 
from another task). SLD then establishes intertask communication 
with HLD on the host system to transfer the required task image. 



Table 4 Task Down-Line Load Sequence 



Satellite 



Host 



1. Operator types: 

>RUN TLK 

2. SLD establishes a 
logical link to HLD. 



3. HLD looks at the HLD 
database for task TLK 
entry. If found, pass 
it to SLD via logical 
link. 



4. SLD loads task into 
core and starts it. 
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Host Loader 



• HLD communicates with SLD on DECnet-llS node to implement 
How n- 1 i ne task load i ng . 

• Tasks to be down-line loaded to RSX-11S node must be 
lTTStalTed in the RSX-TTS "node but not fixed. 

• HLD has a user-defined database to store information about 
the tasks to be down- line loaded. 

• The tasks to be down-line loaded may be general purpose, 
"slfch ~ as TLK in the previous exaropT€-,''~ T "Ttratr"i"s'7 they may be 

down-line loaded to any node. 

• Or the tasks may be node specific, such as a task named AB 
that is to be run on node XYZ : : only. 

• For general purpose tasks to be down-line loaded into 
different RSX-11S systems (that may have different 
configurations) , the LUN FIXING option must have been 
chosen at NETGEN of the RSX-11S SLD task. LUN FIXING 
reinitializes the LUNs after the task has been down-line 
loaded. 

LUN FIXING is optional for RSX-11S systems where only node 
spgi5t^i^"€asks'"are down-line loaded. 

• Checkpointing and overlaying of a task in the RSX-llS node 
is also implemented by using the logical link between HLD 
and SLD. Checkpoint space must be allocated inside the 
task being down-line loaded (by using the /AL switch during 
the task build). Only node-specific tasks can be 
checkpointed back to the host. 
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Example 4 is an example of generating a down-line task loading 
database, and Example 5 shows an HLD database. 



>2LB: C300? nHLDDAT.CMD 

>i HLDDAT - Create/hodif y the down-line task load data base for HLD 

- J SCSS3SSSSSaS = SSZ3Z = = * = Z = 3SSSSSS = S3S = SSSS = = S = SSSZ = S = = SSS:SSE3SSS = 3: = SSS = S 

,- » 
•• » 

•>» Creatina initial com of the down-line task load data base. 

y i 

>* Command LSI: HELP 
.'■ ? 

■i Typina <ESCAPE> to ana Question will provide help on how to answer the 
> » Question. 

? r 

yi The followina commands are supported. 

..- * 

Create new node and/or task entries. 

Terminate the session* replacina the old data base 
contents? and optionally assemble and build the new data 
base. Same as <CTRL/2>. » 

Print this messaae. Same as <ESCAPE>. 

Show all node and task entries. 

Delete old node and/or. task entries. 

Terminate the session with no chanaes to the old data 
base contents. 

: DEFINE 

Define new aeneral purpose tasks? CY/N3J Y 

Define the next aeneral purpose task. If finished* type <RET>. 



y i 


DEFINE 


> * 


EXIT 


y f 




> i 




> * 




> i 


HELP 


y f 




>» 


LIST 


>% 




>» 


PURGE 


s t 




>* 


QUIT 


> i 




>i 




>t 


Command 



>» 

>* 
>* 
>* 



* t 
y * 

y * 

> 5 

> i 

y i 
y i 

>* 



>* 
>* 
y% 
y i 



Gen - Task imaae file (<RET> » done) CSi: DLO: CI * 1003UPDATE.TSK 

Gen - Task, name (Def=UPDATE) CS3: ...UPD 

Gen - Unmapped task (Def=NO>? CY/N3: 

Define the next aeneral purpose task. If finished* tape <RET>. 



Gen - Task imaae file ( <RET> * done) CS3: 
Define new node entry. 



Name of new node ( <RET> = done) CS3: DOULIN 

Define the next task for node DOULIN. If finished* type <RET> 



DOULIN - Task imaae file (<RET> = done) CS]: UPDATE. TSK 
DOULIN -Task name (Def=UPDATE) CS:: ...UP1 
DOULIN - Perform LUN fixina <Def=NO>? CY/NDJ Y 



>» Define the next task for node DOULIN. If finished* type <RET>. 
y t ————————————————————————————————————————————————————————————— 

Example 4 Generating a Down-Line Task Loading Database 

(Sheet 1 of 2) 
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DOULIN - Task imaae file < <RET> « done) [S3: 
Define new node entry. 



Name of new node ( <RET> * done) CS3: 

* Command CS]: EXIT 

Do you wish to task build the HLB data base now? CY/N3*. N 

When you wish to build the HLD down-line task load data base» you iiay 
either execute this command filer and issue the EXIT command* or you 
•ay mount the DECnet object kit on some disk device *ddu* and then 
issue the following commands to NCR. 

ASN ddu:=INt 

SET /UIC=C300.243 

MAC (?HLDTABASM 

TKB 0HLDTABBLD 
>* 
><? <E0F> 

Example 4 Generating a Down-Line Task Loading Database 

(Sheet 2 of 2) 



.TITLE HLDTAB 
♦IDENT /02.001/ 

COPYRIGHT (C) 1981f 1982 BY 

DIGITAL EQUIPMENT CORPORATION* MAYNARD» MASS. 

HLD EXTERNAL TABLE 



.MCALL HLDTBS 

HLBTB* 

HTASKS . ..UPD»<DL0:Cl»1003UPDATE.TSK>fMAP 

HNODES DOULIN 

HTASK* . . •UPl><UPDATE-.TSK>f LUN 

.END 



Example 5 HLD Database 
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Satellite Task Loader 

The SLD must be installed and fixed in the RSX-11S system. 
For example : 

>VMR 

* * * 1 Kb v? Lm t Jb A t? X I CJAliv^ ft ±\^3.^a. «L J. ^3 

VMR> INS [xxx f 64]SLD/FIX=YES 
VMR> LOA OV: 

This establishes SLD as the loading task (LDR...) for the 
RSX-11S executive, RSX-11S task image files are specified during 
network generation. These files are stored under network UIC on 
the host system. The network UIC is [xxx,64] for RSX-11S. 

Additional Notes on Down-Line Task Loading 

• If the RSX-11S operating system is not to be down-line 
system loaded, you must define the node SLD connects to, 
using the VNP SET. EXECUTOR HOST command; for example: 

r >VNP RSX11S 4 

-f VNP> SET EXECUTOR HOST SUPER 

In this example, SUPER is the name of the host node that 
HLD resides^ 

• HLD must be installed on the host system. 



15 



DECnet-RSX ADDITIONAL NETWORK CAPABILITIES 



UP-LINE DUMPING 

You can include certain SET NODE parameters in the permanent 
or volatile database that allow an adjacent RSX-11S or server node 
to dump its memory into a file on the local DECnet-llM or 
DECnet-llM-PLUS node. (A target node can also dump its memory 
up-line to an adjacent DECnet/VAX node). This procedure is 
referred to as up-line dumping. It is a valuable tool for crash 
analysis; that is, programmers can analyze the dump file and 
determine why the RSX-11S system failed. When it (RSX-11S) 
detects an impending system failure, the RSX-11S node requests the 
up-line dump if the appropriate support is selected during the 
RSX-11S system generation. 

Up-Line Dump Requirements 

• The target node must be directly connected to the executor 
node by a physical line. The executor node provides the 
line and circuit level access. 

• The target node must be capable of requesting the up-line 
dump when it detects a system failure. If the dumping 
program (NETPAN) does not exist on the target, up-line 
dumping cannot occur. 

• The executor node circuit involved in the dump operation 
must be enabled and set to ON to perform service functions. 
This is the default state of the circuit following NETGEN. 
For example, the following command prepares circuit DMC-0 
for up-line dumping. 

NCP> SET CIRCUIT DMC-0 SERVICE ENABLE STATE ON 



• If the target does not supply the DUMP COUNT value, the 
executor must have this value in its volatile database. 
RSX-11S systems built with the NETPAN routine always 
include the count. 

• The executor must have a DUMP FILE entry in the volatile 
database . 
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Up-Line Dump Database Parameters 

You can define the following up-line dump parameters in either 
the permanent database, using the CFE DEFINE NODE command, or the 
volatile database, using the NCP SET NODE command: 

• DUMP FILE file — Specifies the file on the host node that 
receives the RSX-11S memory dump. 

• DUMP ADDRESS address — Specifies the octal address in the 
target's memory to begin the dump. 

• DUMP COUNT number — Specifies a default number in decimal 
of 16-bit words to be dumped. 
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MULTIPOINT 
Basic Concepts 

• Three types of multipoint are available: 

- PCL11-B TDM bus 

DMP11/DMV11 microprocessor-based serial interface. 
Implements polling algorithm in microcode. 

Software polling. Implemented in DDCMP software 
(where applicable). 

• Configurations 

PCLll-B (see Appendix -B for details) 

- DMP11/DMV11 (see Appendix C for details) 
Software polling (see the following list) 

• Concepts on software polling 

There is a control station that contains the polling 
algorithm code. This station is responsible for 
selecting the tributary station for communication. 

There can be up to eight tributary stations. Each 
listens to the messages from the control station, 
discarding messages not for itself. It also responds 
with data or ACK when it receives the polling message 
from the master. 

The relationship between the control station and the 
tributaries can be viewed conceptually as 
point-to-point connections from the control station to 
each tributary (see Figure 1). 
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The code is implemented at the DDCMP level. The 
control station polls the tributaries when there is no 
transmission to any tributary. The tributaries listen 
to every message from the master and check the STATION 
ADDRESS field in the DDCMP header to see at whom the 
message is aimed. 

Thus, this technique is suitable for applications with 
low CONTROL-TO-TRIBUTARY traffic. It is not 
recommended if the application involves high 
CONTROL-TO-TRIBUTARY traffic or high TRIBUTARY -TO- 
TRIBUTARY traffic. 



CONTROL 
STATION 



/^ Nline 1 



DR0P1 



DROP 2 



6 © 

TRIBUTARY 



DROPN 



© 



CONTROL 
STATION 




TRIBUTARIES MUTUALLY EXCLUSIVE 



Figure 1 Multipoint Operation 
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CONTROL 
STATION 



KDP 



DROP 



1 




DROP 




DROP 




DROP 




TK-4805 



Figure 2 Configuration Example (Software Polling) 
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The Polling Algorithm 

Conceptually, the polling algorithm is the same for software 
polling and DMPll/DMVll e 

• Selection of the tributary by the control station is 
controlled by two basic mechanisms: 

Transmission directed to a particular tributary. 

Use of a polling list to select the tributary. 

• A tributary can be: 

Nonexistent — Node has not been turned on 
Active — A responding tributary 

— Dying — A tributary that has not responded to the 
last two consecutive polls 

Dead — A tributary that has not responded to the last 
eight consecutive polls (two caused it to be dying) 

• Under NCP/VNP or CFE, the polling rates can be changed by 
altering: 

- Active Polling Ratio (software polling only) — The 
control station polls each active tributary every nth 
time it goes through the polling list, where n is the 
active polling ratio for that tributary. This ratio 
defaults to 1. Thus, the frequency of polling for 
each station can be varied. 

Dying and Dead Polling Ratios (software polling only) 
— This is on a line basis. There is one dead polling 
ratio (X) for all tributaries belonging to the line to 
a control station. The master polls one dead 
tributary each X times through the polling list 
(round-robin). The dead polling ratio default setting 
is 8. The control station polls dying tributaries 
four times as often as a single dead one (or 
one-fourth the dead polling ratio) . 
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NCP > SET CIRCUIT XXX-M.N... 

WHERE M = CONTROLLER NUMBER 
N = STATION NUMBER 



DDCMP 

LINE 

TABLE 



L.PLL 



S.LNK 




W-» 



S.LNK 




S.LNK 




♦ J 



Figure 3 Idle Polling List (All Station Tables) 
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NCP> SET CIRCUIT XXX-M.N STA ON 

where: 

M = Controller number 
N = Station number 

• Set station to ACTIVE polling state 

• Set polling count to the MULTIPOINT ACTIVE rate 

• Set up to send STRT message 

• If first active station on the line, awaken polling 



DDCMP 

LINE 

TABLE 



L.TBP 



STATION 

TARI F 



S.PLL 



S.PLL 



S.PLL 



ACTIVE 

(EVENT-DRIVEN) 

POLLING 

LIST 



(SUBSET OF ALL 
STATION TABLES) 



STATION 

QUEUED UP ONLY IF 
LINE IS NOT SELECTED 
OR LINE IS SELECTED 
BUT THIS STATION IS NOT 
THE CURRENT ONE BEING 
POLLED. 



Figure 4 Active Polling List 
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Polling is Invoked 

• If a select is received on a multipoint master. 

• After a select timeout on a transmitted message to a 
multipoint slave. 

• On startup for the first station on a multipoint line 
(already mentioned). 

• After a one-second timer completion, if one had not been 
previously available to poll. 
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HOW DOES 
POLLING WORK? 



I CTADT DOI I IMC 

H LOGIC 



ANY STATIONS ON 



EVENT-DRIVEN 
QUEUE? 



YES 



ACTIVE/INACTIVE 
RATIO COUNT 
NOW = 0? 

NO - 




DEQUEUE STATION, 
CLOSE UP QUEUE & 
CLEAR STATION'S 
TO-BE-POLLED 
FLAG 



A 



YFS /STATION RETRANS- 
MITTING OR 
SHUTTING DOWN? 






X 
V 



NO 



MARK STATION AS 
SELECTED AND 
SEND THE POLL 



RETURN 



Figure 5 Polling Mechanism (Sheet 1 of 3) 
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IDLE POLLING 
LOGIC 



V 



OBTAIN NEXT 
STATION ADDRESS 
FROM IDLE POLLING 
LIST 



ARE WE AT 
THE END OF 
THE LIST? 



YES 



NO 



DECREMENT THE 
POLLING COUNT 
FIELD FOR THIS 
STATION 



SET FIRST 
STATION IN THE 
LIST AS THE NEXT 
STATION TO POLL 



FORCED POLL 

OF IDLE STATIONS? 



YES 



POLLING COUNT 
NOW = 



YES 



NO 



GET NEXT STATION 
ADDRESS IN QUEUE 



NO 



SET 1 -SECOND 
TIMER FOR 
POLLING DELAY 



V 



RETURN 



Figure 5 Polling Mechanism (Sheet 2 of 3) 
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i I 



SET NEXT STATION 
TO BE POLLED AND 
OBTAIN THIS 
STATION'S POLLING 
STATE 



POLLING STATE 
OFFLINE 



YES 



NO 



^ 



POLLING STATE 



YES. 



DEAD 


r^ 






^ / 


RESET THE POLLING 
COUNT OF ALL 
OTHER DEAD DROPS 
TO THE DEAD 
COUNT 




NO 

















ARE WE IN A 
FORCED POLL 
AND IS THIS AN 
IDLE STATION? 



NO 



YES 



RESET ACTIVE/ 
INACTIVE POLLING 
RATIO FOR THIS 
LINE AND SEND 
THE POLL 



SEARCH ENTIRE IDLE 
POLLING LIST TO 
FIND IDLE STATION 
TO POLL IF ONE IS 
FOUND, BRANCH 
BACK TO START OF 
IDLE POLLING 
LOGIC. IF NOT 
FOUND, POLL THE 
CURRENT STATION 
SELECTED 



RETURN 



Figure 5 Polling Mechanism (Sheet 3 of 3) 
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Ethernet Basic Concepts . 

Ethernet is a high-speed, baseband local area network 
communications network. DIGITAL'S Ethernet specification and its 
implementation conform to the IEEE 802 standard. 

This specification is incorporated in two of the lower layers 
of the DIGITAL Network Architecture (DNA). These layers provide 
packet delivery service between nodes in the network, and 
interface with the higher DNA layers to provide capabilities for 
network management, error recovery, internetwork communication, 
and the user interface. 

The technique for accessing the Ethernet channel is called 
Carrier Sense Multiple Access with Collision Detection (CSMA/CD). 
CSMA/CD can be defined as follows: 

• Carrier Sense (CS) — A device listens for a clear channel 
before transmitting. If the channel is in use (carrier 
detected), the device delays transmission. 

• Multiple Access (MA) — When the channel is clear, all 
users have equal access to it. 

• Collision Detection (CD) — Two or more users may sense a 
clear channel and simultaneously try to transmit. This 
results in collision of data. Ethernet senses the 
collision condition, stops the transmission, and 
automatically tries to retransmit the data after waiting a 
randomly selected amount of time. 
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Ethernet Advantages 

• Simplified Network Design 

Ethernet's architecture and design rules are streamlined 
and uncomplicated. If the cable, transceivers, and 
controllers meet the Ethernet specifications, the design 
rules are as follows: 

- A single cable segment cannot exceed 500 meters in 
length. 

No more than 100 transceivers can be connected per 
cable segment. 

No more than two repeaters can be placed between any 
two nodes in the network. 

- A network cannot exceed 1023 nodes. 

• Simplified Installation 

Ethernet can be brought up one node at a time. A newly 
installed node can communicate immediately with all other 
active nodes on the network. 

m Reduction of Wiring 

Ethernet's single-network cable replaces the many 
interconnecting cables in traditional networks. 
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Ethernet Communications Controllers 

The Ethernet communications controllers connect the host 
system input/output bus to the transceiver cable and provide the 
hardware interface to the cable. DIGITAL has three types of 
Ethernet communications controllers: 

• DEUNA (UNIBUS to Ethernet Communications Controller) 
Used for VAX-11 and PDP-11 UNIBUS host systems. 



• DEQNA (Q-BUS to Ethernet Communications Controller) — Used 
for LSI-11 Q-BUS host systems. 



• DECNA (Professional 300 personal computer to Ethernet 
Communications Controller) — Used for the Professional 300 
Series personal computers. 



See Appendix D for details. 
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APPENDIX A 
Details of Down-Line System Load 



31 



SOFTWARE AT HOST 



to 



1 -INITIALIZE DMR11 

2-BASE INTO DMR11 

3-C0NTR0L IN TO DMR1 1 WITH SEL 6 - 2400 

4-BA/CCI FOR RECEIVE WITH CHARACTER 

COUNT OF 256 
5-BA/CCI FOR TRANSMIT WITH CHARACTER 

COUNT OF 5. TRANSMIT BUFFER IN PDP-1 1 

MEMORY SHOULD LOOK LIKE 6 

(4 PASSWORD THAT « 0) 

SEE NOTE 1 



1 -CHECK VALIDITY OF REQUEST SECONDARY 

BOOT MESSAGE RECEIVED 
2-DO A BA/CCI RECEIVE WITH CHARACTER 

COUNT OF 256. 
3-DO A BA/CCI TRANSMIT WITH CHARACTER 

COUNT OF (X + 12). THE TRANSMIT 

BUFFER CONTAINS MOP MEMORY LOAD 

WITH TRANSFER ADDRESS AS FOLLOWS: 

CODE(1 BYTE) -0 

LOAD NUMBER (1 BYTE) - 

LOAD ADDRESS (4 BYTES) - 



IMAGE DATA LOADED - X BYTES 
TRANSFER ADDRESS (4 BYTES) - 6 
TRANSFER ADDRESS (4 BYTES) - 
TRANSFER ADDRESS (4 BYTES) - 
TRANSFER ADDRESS (4 BYTES) » 



4-SEE NOTE 1 



1 SERIAL 
I LINE 



1 -TRANSMIT ENTER MOP 

MESSAGE 
2-DO A BA/CCO ON TRANSMIT 

DONE 



OLE 
MOP 6 



1 -CHECK FIRST BYTE - 6 

2-COMPARE PASSWORD (PWD) 
RECEIVED WITH PWD SELECTED 
IN LINE UNIT SWITCH PACK El 34 

3-IF ALL 4 PW0« MATCH. DMA 
THE FOLLOWING TO PDP-1 1 
MEMORY 24/174XXX. 26/0 
XXX » LINE UNIT. SW PACK E121 

4-PULL AC LO ON UNIBUS 

SEE NOTE 2 



DO A BA/CCO RECEIVE TO PDP-1 1 



DLE 
MOP 8 



1 -TRANSMIT REQUEST SECONDARY 

BOOT MESSAGE (MOP 8) 
2-DO A BA/CCO TRANSMIT 



1 -TRANSMIT MOP (MEMORY 
LOAD WITH TRANSFER 
ADDRESS) 

2-DO A BA/CCO TRANSMIT 



DLE 
MOPO 



DO A BA/CCO RECEIVE TO 
PDP-11 



DMR1 1 BOOT CODE IN BOOT ROM 
(M9301-YJ/M9312) 



PROGRAM CONTROL IS PASSED TO DMR1 1 
BOOT CODE THAT DOES THE FOLLOWING. 

1 -INITIALIZE DMR11 

2-BASE IN TO DMR1 1 

3-CONTROL IN TO DMR11 WITH SEL6 - 2400 

4-BA/CCI FOR RECEIVE WITH A CHARACTER 
COUNT OF 4092 

5-BA/CCI FOR TRANSMIT WITH CHARACTER 
COUNT OF 4. TRANSMIT BUFFER IN PDP-1 1 
MEMORY SHOULD BE 10, 14. 1. 
(MOP 8: REQUEST SECONDARY BOOT) 

6-SEE NOTE 1 



1 -VERIFY MOP CODE = AT LOCATION 

THEN DO A SYSTEM RESET 
2-JUMP TO LOCATION 6 TO PASS 

PROGRAM CONTROL TO NEWLY 

LOADED PROGRAM 



1) IN DDCMP MAINTENANCE. THERE IS NO RETRANSMISSION; 
BA/CCO FOR A TRANSMIT OPERATION DOES NOT ASSURE 
SUCCESSFUL RECEPTION AT THE REMOTE END. THE SOFTWARE 
MUST KEEP A REPLY TIMER OF 3 SECONDS TO RETRANSMIT THE 
MESSAGE WHEN NO REPLY IS RECEIVED WITHIN THAT TIME 

2) XXX MUST BE THE OFFSET 
FROM 173000 OF THE 

DMR11 BOOT CODE IN M9301-YJ/M931 2 



o 

H 
O 
D 
CD 
ft 
I 

en 
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> 
a 
a 

M 
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O 

2! 

> 

ra 
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o 
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> 

DO 
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r« 

H 
M 
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Figure 6 Typical Down-Line Load Procedure (DMRll to DMR11) 
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MOP 6 MESSAGE = CODE | 4 BYTES EQUAL TO SYSTEM PASSWORD (PASSWORD = FOR iTEP) 
~~6 I PASSWORD I PASSWORD I PASSWORD I PASSWORD 



MOP 8 MESSAGE = CODE | DEVICE TYPE | MOP VERIFY 1 PROGRAM TYPE 



8 



DMC= 12 



1 



SECONDARY LOADER 



MOP MESSAGE = CODE 



MEMORY ADDRESS 



CODE 


LOAD # 


LOAD ADDRESS 4 BYTES 


PROGRAM IMAGE 


TRANSFER ADDRESS 








I 








DATA 


| | 6 I 


S 


1 
i 


2 I 3 


4 


5 


6 



Figure 7 Down-Line Load Message Flow 
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DMC11 Line Unit 



SWITCH PACK 3 
REGISTER 16 



SWITCH PACK 1 





N 


F 
F 


1 
A 


V 


2 

P 


3 


4 


5 


6 


7 


8 






1 2 

N 


F 
F AMP 


3 


4 


5 


6 


7 


8 



W5 W4 W2 W3 




SWITCH PACK 2 
REGISTER 15 




N 


F 
F 


1 
A 


M 


2 
P 


3 


4 


5 


6 


7 


8 





MSB 



LSB 



Figure 8 DMC11 Line Unit 
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Switch Pack 1 — An eight-switch DIP installed in location E26 on 
the M8201 line unit, and in location E29 on the M8202-YA/YD line 
unit. These switches are used to configure the specific line unit 
type. 

Switch Pack 2 — An eight-switch DIP installed in location E87 of 
the M8201 line unit, and in location E90 on the M8202-YA/YD line 
unit. This switch pack is used only during down-line load 
procedures, and is configured for the required MOP password. 

Switch Pack 3 — An eight-switch DIP installed in location E88 of 
the M8201 line unit, and in location E91 on the M8202-YA/YD line 
unit. This switch pack is used only during down-line load 
procedures and is configured for the required boot offset address. 

Configure switch pack 2 for selection of the special Remote 
Load Detect (RLD) bootstrap password. Table 5 represents a 
detailed description of the switch settings for switch pack 2 of 
the M8201 and M8202-YA/YD line unit. This switch pack is only 
used for down-line load, and is configured for the bootstrap 
password. 

Table 5 M8201/M8202-YA/YD Switch Pack 2 
Bootstrap Password 

Switch Function 



NOTE 
Switch OFF equals a logical one (1). 

1-8 Bootstrap Password Selection — These switches are 

physically connected to IBUS register 15, with switch 
1 being the most significant bit and switch 8 the 
least significant bit. In the DMC11, this switch 
pack contains the bootstrap password if the bootstrap 
feature is being used. Otherwise it contains an 
octal 377 (switches 1 through 8 OFF (open)) that 
disables the RLD feature. 

Example of a password of octal 012: 
Switch 



MSB 














LSB 


1 


2 


3 


4 


5 


6 


7 


8 


ON 


ON 


ON 


ON 


OFF 


ON 


OFF 


ON 
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Configure switch pack 3 for selection of the special RLD boot 
offset address. Table 6 represents a detailed description of the 
switch settings for switch pack 3 of the M8201 and M8202-YA/YD 
line unit. This switch pack is only used for down-line load, and 
is configured for the boot offset address. 

Table 6 M8201/M8202-YA/YD Switch Pack 3 
Boot Offset Address 

Switch Function 



NOTE 
Switch OFF equals a logical one (1). 



1-8 Bootstrap Offset Address Selection — These switches 
are physically connected to IBUS register 16, with 
switch 1 being the Most Significant Bit (MSB) and 
switch 8 the Least Significant Bit (LSB). When the 
RLD feature is used, switch pack 2 (switches 1-8) must 
contain the appropriate offset entry address in the boot- 
strap program. The address formed by the DMC11 is 
173XXX, where XXX is the content of E88 or E91 
switches 1-8. Variations in bootstrap ROMs may 
require different entry addresses to boot the 
DMC11/DMR11. If the RLD feature is not used, the 
offset must be set to octal 377, switches 1-8 all 
OFF (open) . 

The following examples are for the M9301-YJ bootstrap 
module. Depending on the bootstrap module used, 
reference should be made to the appropriate manual for 
specific details. 

1. M90301-YJ Bootstrap Technical Manual 

2. M9312 Technical Manual 
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Table 6 M8201/M8202-YA/YD Switch Pack 3 
Boot Offset Address (Cont) 



Switch Function 



To boot DMC11 unit without CPU diagnostics, address 
356 must be selected: 

MSB LSB 

Switch 12345678= 356 
OFF OFF OFF ON OFF OFF OFF ON 

To boot DMCI1 unit 1 without CPU diagnostics, address 
374 must be selected: 

MSB LSB 

Switch 1 2 3 4 5 6 7 8 = 374 
OFF OFF OFF' OFF OFF OFF ON ON 

To boot DMC11 unit with CPU diagnostics, address 354 
must be selected: 

MSB LSB 

Switch 12 34 5 67 8= 354 
OFF OFF OFF ON OFF OFF ON ON 

xkj uwui. un\~x± uuxu ± wiuu uiru u zaynub lxc& , auuicss j/z 

must be selected: 

MSB LSB 

Switch 12345678= 372 
OFF OFF OFF OFF OFF ON OFF ON 
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DMR11 Line Unit 



BOOTSTRAP PASSWORD 
(IBUS REGISTER 15| 




N 


F 

F 


sr 




H 








H 








H 




H 


N 


/IS 


1 


= 




i 



r-NOT USED 

MICRODIAGNOSTIC 



SWITCH ON = 
SWITCH OFF = 1 




SWITCH PACK E134 

BOOTSTRAP OFFSET 
(IBUS REGISTER 16) 



|- DMC LINE COMPATIBILITY 
i— HIGH-SPEED SELECT 



01 23456789 10 



F 
F L§B 



z 



MSB 



SWITCH PACK E121 

W7 W3 W4 wg 



iiinimiiiii|)(Timttnnnn 



WT 



71 I 1 \ iy^ 

W15fl 

W14Q 



W, W2 W8 W\2 W1 ° 




rl 



SWITCH PACK E39 



• SELECTS DATA RATE 
(SEE TABLE 2) 



«- SELECTS RS-422 INTERFACE 
I- RESERVED 
*- SELECTS V-35 INTERFACE 



SELO 
BIT 13 


SW10 AT 
El 34 ON 
M8203 


EXECUTION OF MICRODIAGNOSTICS 


CLEAR 
CLEAR 
SET 
SET 


ON 
OFF 
ON 
OFF 


NO MICRODIAGNOSTICS IS RUN 
RUN MICRODIAGNOSTICS 
RUN MICRODIAGNOSTICS 
NO MICRODIAGNOSTICS IS RUN 



SW9 


SW10 


CONFIGURATION 


ON 


ON 


DDCMP VERSION 4.0 (NOT CONNECTED 
TO DMC1 1 ) WITH LINE SPEED LESS 
THAN 1 M B/S. 


ON 


OFF 


DDCMP VERSION 4.0 (NOT CONNECTED 
TO DMC1 1 ) WITH LINE SPEED AT 1 M 
B/S. 


OFF 


ON 


CONNECTED TO LOW-SPEED DMC1 1 -DA 
(M8200 YA} 


OFF 


OFF 


CONNECTED TO HIGH-SPEED DMC11-AL 
(M8200 YB) 



SPEED 


SWITCH 


8 


9 


10 


1 MEG 


ON 


ON 


ON 


500K 


OFF 


ON 


ON 


250K 


ON 


OFF 


ON 


56K 


OFF 


OFF 


ON 


*19.2K 


ON 


ON 


OFF 


9.6K 


OFF 


ON 


OFF 


4.8K 


ON 


OFF 


OFF 


2.4K 


OFF 


OFF 


OFF 



* NORMAL SWITCH SETTING UNLESS 
THE INTEGRAL MODEM OR NULL 
MODEM CLOCK FEATURES ARE USED. 





SW5 


SW6 


SW7 


RS-232-C OR RS423-A 
OR INTEGRAL** 


OFF 


OFF 


OFF 


V.35 


ON 


OFF 


OFF 


RS-422 


OFF 


OFF 


ON 



* * INTEGRAL MODEM IS SELECTED BY BC55R 
CABLE WHEN INSTALLED IN J1 OF THE 
M8203 LINE UNIT. MODULE CONNECTOR 
J2 MUST NOT HAVE ANY CABLE OR TEST 
CONNECTOR INSTALLED. 



Figure 9 DMRll Line Unit 
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Switch Pack E39 — This switch pack enables the user to select the 
desired interface option and line speed. 

Switch Pack E121 — During down-line load, this switch pack is 
used to configure the required BOOT OFFSET address. The switch 
pack is also used normally to select device and speed 
compatibility. 

Switch Pack E134 — During down-line load, this switch pack is 
used to configure the device for the proper MOP password. This 
switch pack is also normally used for autoanswer and 
microdiagnostic enabling or disabling. 
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Table 7 Switch Pack E134 Description 



Switch Function 



NOTE 
Switch OFF equals a logical one (1) 



1-8 Bootstrap Password Selection — These switches are 

physically connected to IBUS register 15, with switch 
1 being the least significant bit and switch 8 the 
most significant bit. In the DMRll, this switch 
contains the bootstrap password if the bootstrap 
feature is being used. Otherwise it contains an 
octal 377 (switches 1-8 OFF (open)). A password of 
377 disables the RLD feature. 

Example of a password of octal 012: 
Switch 



LSB 














MSB 


1 


2 


3 


4 


5 


6 


7 


8 


ON 


OFF 


ON 


OFF 


ON 


ON 


ON 


ON 



Autoanswer Enable — When this switch is in the ON 
position, autoanswer is disabled. Following a 
powerup or master clear, the DMRll asserts DTR, 
allowing the DMRll to answer an incoming call for 
remote load. The call terminates only when the 
user program issues a Halt Request or the remote 
end terminates the call. 

When this switch is in the OFF position, autoanswer 
is enabled. This allows the DMRll to monitor the 
Ring Indicator (RI) and Data Set Ready (DSR) to 
answer and control incoming calls. Control is 
established using a 20-second call set-up timer. 
Also, if the DMRll is connected to a modem and the 
user program has not assigned Base In/Control In to 
the DMRll, when the DMRll detects Ring Detect (RD) 
it drops DTR to disable answering the call. This 
switch is physically connected to IBUS register 11 
bit <13>. 



40 



DECnet-RSX ADDITIONAL NETWORK CAPABILITIES 



Table 8 Switch Pack E121 Description 



Switch Function 



NOTE 
Switch OFF equals a logical one (1) 



1-8 Bootstrap Offset Address Selection — These switches 
are physically connected to IBUS register 16, with 
switch 1 being the least significant bit and switch 8 
the most significant bit. When the RLD feature is 
used, switch pack E121 (switches 1-8) must contain the 
appropriate offset entry address in the bootstrap 
program. The address formed by the DMRll is 173XXX, 
where XXX is the content of E121, switches 1-8. 
Variations in bootstrap ROMs may require different 
entry addresses to boot the DMC11/DMR11. If the RLD 
feature is not used, the offset must be set to octal 
000, switches 1-8 all ON (closed). 



NOTE 

microdiagnostics in the bootstrap 
ROM module (M9301-YJ or M9312) 
must be disabled. 



The following examples are for the M9201-YJ bootstrap 
module. Depending on the bootstrap module used, 
reference should be made to the appropriate manual 
for specific details. 

1. M9301-YJ Bootstrap Technical Manual 

2. M9312 Technical Manual 

To boot DMRll unit without CPU diagnostics, address 
356 must be selected: 

LSB MSB 

Switch 12345678= 356 
ON OFF OFF OFF ON OFF OFF OFF 
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Table 8 Switch Pack E121 Description (Cont) 



Switch Function 



To boot DMR11 unit 1 without CPU diagnostics, address 
374 must be selected: 



LSB 














MSB 




1 


2 


3 


4 


5 


6 


7 


8 


374 


ON 


ON 


OFF 


OFF 


OFF 


OFF 


OFF 


OFF 





LSB 














MSB 




1 


2 


3 


4 


5 


6 


7 


8 


354 


ON 


ON 


OFF 


OFF 


ON 


OFF 


OFF 


OFF 





LSB 














MSB 




1 


2 


3 


4 


5 


6 


7 


8 


372 


ON 


OFF 


ON 


OFF 


OFF 


OFF 


OFF 


OFF 





Switch 



To boot DMR11 unit with CPU diagnostics, address 354 
must be selected: 



Switch 



To boot DMR11 unit 1 with CPU diagnostics, address 372 
must be selected: 



Switch 



9 DMC Line Compatible — The DMR11 microcode uses this 
switch to determine whether to implement the DIGITAL 
Data Communications Message Protocol (DDCMP), Version 
4.0 or DMC Line Compatible Mode. The switch is physically 
connected to IBUS register 11 bit <2>. 

o OFF = DMC11 Line Compatible Mode 

o ON = DDCMP Version 4.0, DMR11 Operating Mode 

10 High-Speed Select — The DMR11 microcode uses this 
switch to determine if the device is running a 1M bps 
(because the microcode is modified at that speed). 
This switch is physically connected to IBUS register 11 
bit <1>. 



NOTE 
The combination of switches 9 and 10 
must be appropriately selected to 
satisfy the configuration requirements 
as listed in Table 9. 
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Table 9 Switch Pack E121 Description 



Switch 9 Switch 10 Configuration 



ON ON DDCMP Version 4.0 (not connected to 

DMC11), with line speed less than 1M 
bps. 

ON OFF DDCMP Version 4.0 (not connected to 

DMC11), with line speed at 1M bps. 

OFF ON Connected to low-speed DMC11-DA 

(M8200-YA) . 

OFF OFF Connected to high-speed DMC11-AL 

(M8200-YB) . 
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DMP11 Line Unit 



HIGH SPEED* OFF 
LOW SPEED -ON 



TRIBUTARY 
ADDRESS/PASSWORD 
(BUS REGISTER 15) 




SWITCH PACK E134 



SWITCH ON = 
SWITCH OFF = 



MODE ENABLE = OFF 

REMOTE LOAD 

DETECT = OFF 

POWER ON 

BOOT = ON 






SWITCH 


+ MODE DEFINITION 


5 


6 


7 


HEX PT-TO-FT/DMC LINE COMPATIBLE 
FDX PT-TO-PT/DMC LINE COMPATIBLE 
HDX PT-TO-PT 
FDX FT-TO-PT* 

MDX MULTIPOINT CONTROL STATION * 
FDX MULTIPOINT CONTROL STATION * 
HDX MULTIPOINT TRIBUTARY* 
FDX MULTIPOINT TRIBUTARY* 


ON 

OFF 

ON 

OFF 

ON 

OFF 

ON 

OFF 


ON 

ON 

OFF 

OFF 

ON 

ON 

OFF 

OFF 


ON 

ON 

ON 

ON 

OFF 

OFF 

OFF 

OFF 



SWITCH PACK E121 




W7 VV3 W4 W5 






!? 17 W1W2| W12 
W8 




•NORMAL SWITCH SETTING UNLESS THE 
INTEGRAL MODEM OR NULL MODEM CLOCK 
FEATURES ARE USED. 



RS-232-C OR RS-423-A 
OR INTEGRAL** 



RS-422 



SW5 SW6 SW7 



OFF OFF 



OFF 



OFF 



••INTEGRAL MODEM IS SELECTED BY BC55J 
CABLE WHEN INSTALLED IN Jl OF THE 
M8203 LINE UNIT. MODULE CONNECTOR 
J2 MUST NOT HAVE ANY CABLE OR TEST 
CONNECTOR INSTALLED. 



Figure 10 DMPll Line Unit 
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Table 10 Switch Pack E121 Selections 



Switch Function 



NOTE 
Switch OFF equals a logical one (1). 



1-4 Unit Number Selection — These switches are physically 
connected to IBUS register 16 bits 0-3, with switch 1 
being the least significant bit and switch 4 the most 
significant bit. The unit number is used to identify 
each unique DMPll if several are installed on the same 
system. This is particularly important for systems 
using the RLD and boot features of the DMPll. The boot 
program must know which of the DMPlls in the floating 
address space is performing the down-line load. 

5-7 Mode Definition Selection — These switches are 

physically connected to IBUS register 16 bits 4-6, and 
are used in conjunction with switch 8 to define the 
mode of operation for the DMPll. 

Switch 

Mode 5 6 7 

HDX PT-TO-PT/DMC Line Compatible 
FDX PT-TO-PT/DMC Line Compatible 
HDX PT-TO-PT* 
FDX PT-TO-PT* 

HDX MULTIPOINT CONTROL STATION* 
FDX MULTIPOINT CONTROL STATION* 
HDX MULTIPOINT TRIBUTARY* 
FDX MULTIPOINT TRIBUTARY* 

*DDCMP Version 4.0 

8 Mode Enable — This switch is physically connected to 

IBUS register 16 bit 7, and is used to indicate that 
the mode definition is actually selected in switches 
5-7. 

Switch in OFF Position: Mode defined in switches 

Switch in ON Position: Mode not defined in switches 
defined by software (overridden by software) ► 
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ON 


OFF 


ON 


OFF 


ON 


ON 


ON 


OFF 


ON 


OFF 


OFF 


ON 


ON 


ON 


OFF 


OFF 


ON 


OFF 


ON 


OFF 


OFF 


OFF 


OFF 


OFF 
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Table 10 Switch Pack E121 Selections (Cont) 



Switch Function 



9 Remote Load Detect — This switch is physically 
connected to IBUS register 11 bit 2, and is used 
to enable the RLD feature of the DMPll. 

Switch in OFF Position: Enables 
Switch in ON Position: Disables 

10 Power ON Boot — This switch physically connected 
to IBUS register 11 bit 1, and is used to enable 
or disable the power ON boot feature of the DMPll 

Switch in OFF Position: Disables 
Switch in ON Position: Enables 



NOTE 
If the RLD and power on boot features 
are used, then switches 1 through 10 
must be appropriately set. RLD and 
power on boot features are only appli- 
cable to the PDP-11 processors and do 
not apply to VAX-11 processors. 
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Table 11 Switch Pack E134 Selections 



Switch Function 



NOTE 
Switch OFF equals a logical one (1). 



1-8 Tributary Address/Password — These switches are 

physically connected to IBUS register 15 bits 0-7, 
with switch 1 being the least significant bit and 
switch 8 being the most significant bit. The 
tributary address switches allow the user to define 
the address in switches to which the device responds, 
for message traffic over the communication link. 
Valid addresses are: 1 for point-to-point stations 
and 1 through 255 for multipoint tributary stations; 
address of zero is illegal. If the power ON boot 
and RLD features are used, these switches must be 
set to the tributary address. In addition, for RLD, 
this address also serves as a password for the 
maintenance message ENTER MOP MODE. (Tributary 
address and password must be equal.) 



9 Not used in uMfII — This switch is physically 
connected to IBUS register 11 bit 3. 

10 High Speed/Low Speed — This switch is physically 
connected to IBUS register 11 bit 5. The setting 
of this switch indicates to the microcode whether 
the data rate over the communication line is greater 
or less than 250K bps. 

Switch in OFF Positions High speed (250K bps) 
Switch in ON Position: Low speed (<250K bps) 



NOTE 
If the boot feature is selected, it is 
mandatory that the switches in switch 
packs E121 and E134 be appropriately 
configured according to the following 
charts. 
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Table 11 Switch Pack E134 Selections (Cont) 



Switch 


Function 














E121 


LSB 

1 2 
OFF OFF 


3 
ON 


MSB 
4 5 
ON OFF 


6 
OFF 


7 8 9 
OFF OFF ON 


10 
ON 






Example: 


Unit 


Number 3, 


Mode 


= FDX TRIB 






E134 


LSB 

1 2 
OFF OFF 

X = Don't 


3 
ON 

care 


4 5 
OFF OFF 


6 
OFF 


MSB 
7 8 9 10 
OFF ON X X 

High/ Low 
Speed 



Example: Trib address = 123 (decimal); must be 
set in octal representation (123 = 173 ) 

10 8 



E121 



E134 



LSB 

1 2 
ON ON 


3 

OFF 


MSB 
4 5 
ON ON 


6 7 

OFF OFF 


8 
OFF 


9 10 
OFF OFF 


Example: 


Unit 


Number = 


4, Mode = 


HDX TRIB 


LSB 

1 2 
OFF OFF 

X = Don't 


3 
ON 

care 


4 5 
OFF OFF 


6 7 
OFF OFF 


MSB 

8 

ON 


9 10 
X X 

High/Low 
Speed 



Example: Trib address and password =123 
(decimal); must be set in octal representation 
(123 = 173 ) 
10 8 
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DMV11 Microprocessor and Line Unit 



yik 



VI 



E113 


E101 



Pl 



jH 



J2 



M8053 



E54 



E53 



J1 



Jl 



n 



i 



Figure 11 DMV11 Microprocessor and Line Unit 
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DDCMP ADDRESS REGISTER 
TRIBUTARY/PASSWORD 



E 119 (M8064) 
E113(M8053) 



ZERO - ON 



z. 



MODE UNIT 

ENABLE NUMBER 
FOR 
BOOTING 



\\ s, 



6 7 
i 



N. 



AUTO 
ANSWER 



K ~ 



POWER 
ON 
BOOT 
ENABLE 



REMOTE 
LOAD 
DETECT 
ENABLE 



MODE WHEN 
SWITCH ONE 
IS SET 



E 107 (M8064) 
E101 (M8053) 



ZERO = ON 



6 


7 


8 


SWITCH SETTING FOR THE MODE OF OPERATION. 


ON 


ON 


ON 


HDX PT-TO-PT DMC COMPATIBLE 


OFF 


ON 


ON 


FDX PT-TO-PT DMC COMPATIBLE 


ON 


OFF 


ON 


HDX POINT-TO-POINT 


OFF 


OFF 


ON 


FDX POINT-TO-POINT 


ON 


ON 


OFF 


HDX CONTROL STATION 


OFF 


ON 


OFF 


FDX CONTROL STATION 


ON 


OFF 


OFF 


HDX TRIBUTARY STATION 


OFF 


OFF 


OFF 


FDX TRIBUTARY STATION 



9 


10 


/ 


* 

-A. 



HIGH ON — V.35 

SPEED OFF - EIA 
M8053 

E 107{M8064) 
E 101 (M8053) 
OFF = LOGIC ONE 



HIGH-SPEED SWITCH 
MUST BE SET 
FOR INTEGRAL 
MODEM OR WHEN 
RUNNING ABOVE 19.2KB 

* UNUSED 
ON 
M8064 



ZERO = ON 



MKV84-1157 



Figure 12 DMV11 Switch-Selectable Features 
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M9301-YJ Bootstrap Module 

Special customer configurations for RLD may require a M9301-YJ 
or M9312 bootstrap module* The M9301-YJ and M9312 bootstrap 
modules (M9301-YJ, see Figure 13) provide DECnet bootstrapping 
capabilities for the DMCll/DMRll on PDP-11 systems with or without 
the console switch register. Refer to Table 12 for a description 
of M9301-YJ switch settings. 



S-2 



*r£ 



J a aflQfl 




i i i i i 



i — i i — i 



1 1 1 1 1 1 1 1 1 1 1 



IZZJ EZZ CD CZZI 

nu nn en izzi 



izz czzi 






SWITCH PACK NO. 1 



i 



MKV84-1124 



Figure 13 M9301-YJ Bootstrap Module 
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Table 12 M9301-YJ Switch Settings for DHC11 or 
DNR11 Bootstrapping from Console 

Octal 
Function Sl-1 2 3456789 10 Code 



Vector 24 - OFF 



Console 

Emulator 

with Diag. ON ON ON ON ON ON ON ON ON ON 000 

Unit 

with Diag. ON ON ON OFF OFF OFF ON OFF OFF ON 354 

Boot DMC11/DMR11 

Unit 

without Diag. - ON ON OFF OFF OFF ON OFF OFF OFF 356 

Boot DMC11/DMR11 

Unit 1 

with Diag. ON ON ON OFF OFF OFF OFF OFF ON OFF 372 

Boot DMC11/DMR11 

Unit 1 

without Diag. - ON ON OFF OFF OFF OFF OFF OFF ON 374 

Note that when using the console boot switch, the state of Sl-2 
has no relevance. 
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M9312 Bootstrap Module 



BOOT ROM 
#1 



0°^ 



£=dqE!T[ 




F ASTON TABS 
TP4 TP3 TP2 TP1 

QQflfl 




""T it i Qr^ 

v* i- T « 



10 ROM ENA H 
JUMPER W-S 




ADDRESS OFFSET 

'SWITCH BANK 81 

<E37| 



•CONSOLE EMULATOR 
& DIAGNOSTIC ROM 



Figure 14 M9312 Bootstrap/Terminator Module 
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M9312 Setup for DMC11 Down-Line Load 

The DMC11 ROM locations (MR11K-AA kit) and the M9312 switch 
settings required for DMR11 down-line load are as follows {see 
Figure 14). 

Table 13 Switch Settings for DMR11 Down-Line Load 



ROM Location Start** 



S-l Settings 



Davica (MR11K-AA) Unit Address 123456789 10 

DMR11 ROM1 23-862A9 173004 OFF * OFF OFF OFF OFF OFF OFF ON OFF 

ROM2 23-8 63A9 
ROM3 23-864A9 1 173030 OFF * OFF OFF OFF OFF ON ON OFF OFF 

DMR11 ROM2 23-862A9 173204 OFF * OFF ON OFF OFF OFF OFF ON OFF 

ROM3 23-863A9 
ROM4 23-864A9 1 173230 OFF * OFF ON OFF OFF ON ON OFF OFF 

* When ON, Sl-2 enables power boot. (Must be OFF for PDPll/60. See PDPll/6"0 
documentation for power-up boot. On an 11/34, this is a "don't care" switch.) 
If in doubt, the suggested setting for Sl-2 is OFF. 

** The starting address for the console load address and start sequence. 



CAUTION 
The boot ROMs MOST absolutely and without 
exception be installed in sequence, that is, 
23-862A9 through 23-864A9 in boot ROM 
positions 1 through 3, or in boot ROM 
positions 2 through 4. A halt at location 
173124 or 173324 is the indication of ROM 



misplacement. 
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DEUNA Set Up 

The remote boot and down-line load features implemented in the 
DEUNA are used to allow the PDP-11 system in which the DEUNA is 
installed to be booted and to load a system image into the 
processor. This function is useful with systems requiring remote 
booting and loading of their system images. Figure 15 shows a 
basic PDP-11 system with a DEUNA. 



PDP-11 
PROCESSOR 



c 



DEUNA 



UNIBUS 



> 



BOOT 
MODULE 



ETHERNET 



Figure 15 PDP-11 System 



System Configuration Guidelines — When configuring a system to be 
remote booted and/or down-line loaded use the following 
guidelines: 

• System Processor 

-» - When ACLO is asserted on the UNIBUS, the processor must 
be set up to assert DCLO (powerfail sequence). 

When DCLO is asserted, the processor is initialized and 
then HALTED. For a boot from ROM function, the 
processor should start to execute from the boot ROM on 
the system boot module. 
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• System Boot Module (except for boot from boot ROM) 
Disable powerup boot 
Disable system self-test 

NOTE 
When configuring a system to meet these 
guidelines, refer to the processor and boot 
module manuals for the system. 

Table 14 summarizes the system configuration guidelines. 



Table 14 Remote Down-Line Load Configuration Guidelines 



DEUNA Boot Function 



Boot Module 



Processor 



Boot with ROM 



Remote Boot 



Remote/Powerup Boot 



Configure for 
boot from ROM 

Disable boot on 
power up 
Disable system 
self-test 

Disable boot on 
power up 
Disable system 
self-test 



ACLO — > DCLO 
Boot from ROM 

ACLO — > DCLO 
Initialize and HALT 



ACLO — > DCLO 
Initialize and HALT 



Remote Boot Disabled — Remote boot is disabled when the BOOT SEL 
switches are configured as follows: 

BOOT SEL = ON 
BOOT SEL 1 = ON 

When remote boot is disabled, the system processor can only be 
booted by the DEUNA by using a BOOT port command. It cannot be 
booted by using a boot request from another node on the Ethernet. 
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Remote Boot with System Load — Remote boot with system load is 
enabled when the BOOT SEL switches are configured as follows: 

BOOT SEL = ON ■ 
BOOT SEL 1 = OFF 

When remote boot with system load is selected, the DEUNA 
accepts a boot message received on the Ethernet, boots the system 
processor and down-line loads the system image. 

When a boot message for system boot is received from another 
station on the Ethernet (NI), the DEUNA performs the following 
( see Figure 16) . 

• Boot message is received by DEUNA, 

• The DEUNA checks the verification code, message type, and 

so on. 

• The DEUNA transfers a program from ROM by using DMA to 
system memory. 

• The DEUNA asserts ACLO. This simulates a powerfail to the 
system. 

• The DEUNA sends a program request message onto the NI and 
waits for a memor v7 load with transfer address. The n roT5ip. 
request message is sent every five seconds for the first 
eight messages, then every 30 seconds until the memory load 
with transfer address is performed. 

• The DEUNA checks the memory load message, transfers it to 
WCS, then executes the instructions starting at the 
transfer address. 

The program loaded into WCS is the secondary loader. This 
loader is used to bring a tertiary loader into system 
* memory. The tertiary loader is used to load the system 
image . 
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DEUNA 



Nl 



CHECK VERIFICATION 
CODE, MESSAGE 
TYPE, ETC. 

TRANSFER PROGRAM 
VIA DMA 



BOOT 



BOOT MESSAGE 



ASSERT ACLO 

EVERY 5 SECONDS 
FOR 8 MESSAGES 
EVERY 30 SECONDS 
AFTER 8TH MESSAGE 



PROGRAM REQUEST 



HOST LOADER 



MfctfOjii 



•CHECK MESSAGE '*vJ\tH 
'TRANSFER TO WCS 
'EXECUTE 



-fBA' 



^^ 



DEUNA BOOT SWITCH SETTINGS: 
BOOTSEL = ON 
BOOTSEL 1 =OFF 



Figure 16 Remote Boot with System Load Functional Flow 
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Remote Boot with ROM — When remote boot with ROM is selected, the 
DEUNA accepts a boot message received on the Ethernet, then boots 
the system by using ROM-based instructions contained on the system 
boot module. 

Remote Boot with ROM is selected when the boot select switches 
are configured as follows: 

BOOT SEL = OFF 
BOOT SEL 1 - ON 

When a boot message for system boot is received from another 
station on the NI , the following sequence occurs (Figure 17): 

• The DEUNA checks the verification code, message type, and 
so on. 

• The DEUNA asserts ACLO? this simulates a power failure to 
the system. 

• The system then performs a powerup boot using the ROM-based 
boot program. 

e The boot program, in addition to booting the system, 
should: 

Self -test the system 

Issue a BOOT port command to the DEUNA 

• The DEUNA then enters the primary load state. 
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PDP-11 



REMOTE BOOT 
LOCAL POWER-UP 
BOOT 



DEUNA 



Nl 



CHECK VERIFICATION 
CODE, MESSAGE TYPE, 
ETC. 

ASSERT ACLO 



BOOT MESSAGE 



SYSTEM BOOT MODULE 

•SHOULD EXECUTE 
SELF-TEST 

'ISSUE BOOT 
PORT COMMAND 

EVERY 5 SECONDS 
FOR 8 MESSAGES 

EVERY 30 SECONDS 
AFTER 8TH MESSAGE 



PROGRAM REQUEST 



•CHECK MESSAGE 
•TRANSFER TO WCS 
•EXECUTEISTART 
AT TRANSFER ADDRESS) 




HOST LOADER 



^** 



DEUNA BOOT SWITCH SETTINGS 
BOOT SEL0 = OFF 
BOOTSEL 1 = ON 



Figure 17 Remote Boot with ROM Functional Flow 
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Remote Boot/Powerup Boot with System Load — When the DEUNA is 
configured for Remote Boot/Powerup Boot with System Load, the 
DEUNA can boot and perform a system load oyer the Ethernet in two 

w c* jf o • 

• On system power up 

• On receipt of boot message over the Ethernet 

The boot select switches on the port module of the DEUNA are 
configured as follows: 

BOOT SEL = OFF 
BOOT SEL 1 = OFF 

When the system is powered up, the DEUNA performs the 
following (Figure 18): 

• Transfers a program from ROM by using DMA to system memory. 

• Asserts ACLO? this simulates a power failure to the 
system. 

• Sends a program request message onto the NI and waits for a 
memory load with the transfer address. The program request 
message is sent every five seconds for the first eight 
mcssaccs # then evsrv 30 seconds until the memor 17 load with 
transfer address is performed. 

• Checks the memory load message, transfers it to WCS, then 
executes the instructions starting at the transfer address. 

The program loaded into WCS is the secondary loader. This 

loader is used to bring a tertiary loader into system 

memory. The tertiary loader is used to load the system 
image. 

Whe*n the DEUNA receives "a boot message from another station on 
the Ethernet, it functions in the same manner as a Remote Boot 
with System Load. 
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APPENDIX B 
PCL11-B Parallel Communications Link 

Features 

• DMA block transfer multi-CPU link 

• Up to 16 PDP-11 or VAX-11 computers 

• Hardware protocol with error checking: CRC and word parity 

• PCL11 bus bandwidth is up to 1M bps 

• Time division multiplex bus with adjustable time slicing 

• RSX-11M and VAX/VMS device driver available 

• Failure protected for high-availability systems 

• Individual nodes can be powered-off 

• PCLll bus is T-connected; not daisy-chained 

• Computers can be removed with PCLll bus running 

• Any nOue Can uc caSiiy Set up a5 uuo timing master 

• Automatic failure from primary to secondary PCLll bus 
master 

• Receiver can reject transmitter under program control 
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Figure 19 Multiple Processor System Using the PCL11-B 
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ThePCLH 

The Parallel Communications Link (PCL11) is a high-performance 
computer link used for interconnecting multiple PDP-11 and/or 
VAX-11 computers in a local distributed processing network. Up to 
16 processors can be connected to the PCL11 network. Each 
computer can send or receive messages or data blocks to or from 
any other computer in the network. Communications occur in a DMA 
block transfer mode over a Time-Division-Multiplexed (TDM) 16-bit 
parallel bus. Because of the TDM nature of the PCL11 bus, up to 
16 conversations may be conducted concurrently. 

The power and features of the PCL11 system make it the 
appropriate multiprocessor communications link for applications of 
five or more processors in local networks. The PCL11 allows for 
communications between any computer pair in the network, a 
flexibility that would otherwise require a very large number of 
two-processor links. 

Even if your network is starting at three or four processors 
with potential growth later, the PCL11 offers an advantage: the 
ability to add more processors to the network by adding additional 
PCL11 nodes. There is no need to disrupt or reconfigure the 
existing nodes in the network. 

The PCLll is used to build local networks in a variety of 
applications. These include distributed processing, distributed 
database management, industrial data collection and control 
systems, simulation systems, transaction processing, laboratory 
data collection and control networks. 

Transparency of Operation 

The user experiences transparency of operation. The PCLll 
hardware manages the protocol and error checking for establishment 
of communication with a desired recipient computer and for 
successful transfer of the data or message. The user tells the 
PCLll what data is to be sent to which recipient computer. The 
user is then notified upon successful completion of the transfer. 
If after multiple attempts the PCLll is unsuccessful in 
transferring the data, it informs the user of this with an 
indication of the reason (receiver busy, no acknowledgment, 
unresolved errors, and so on). 

Error Checking 

The PCLll hardware provides error checking in the hardware by 
use of work parity and block CRC-16. If an error is detected, the 
message is automatically retransmitted by the software driver. 
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High-Availability Systems 

The PCL11 is designed for use in high-availability systems. 
The connection of the PCLll interface on each computer to the 
PCLll bus is such that a computer and interface can be powered on 
or off without disabling the bus or the rest of the network. The 
bus is connected to the computer and interface by a T connection, 
not a daisy-chain. A computer can even be physically unplugged 
from the PCLll bus, moved away, and replaced without stopping the 
network. If a data error occurs, the error is detected by the 
hardware and the data is automatically retransmitted by the 
software driver. 

Provision is made for backup of the PCLll unit that is 
clocking the PCLll bus. If the PCLll interface on the network 
designated to clock and control the PCLll bus fails, a designated 
secondary or backup PCLll unit automatically assumes control. 
That computer is notified of the action and the user may, by using 
software, designate a new secondary or backup PCLll unit. All 
PCLll units are identical and any unit can be designated as master 
or secondary. 

High Bandwidth and Flexibility 

The PCLll provides high-bandwidth data transfer rates plus 
flexibility in the allocation of that bandwidth among the various 
nodes in the network. 

The maximum PCLll bus bandwidth is 1M bps. There are two 
mechanisms for dividing the bandwidth among nodes. The default 
allocation simply divides the bus bandwidth equally among the 
PCLll nodes on the bus. That is, the TDM time slices go 
round-robin among the nodes. 

In addition, the allocation of the TDM time slices can be set 
and varied under software control. The user may load a register 
in the^ PCLll with an explicit list of the time-slice allocations 
by transmitter number. This can be set to give whatever bandwidth 
allocation is desired to different PCLll transmitters in the 
network to handle differing data rate requirements including a 
maximum of half of the bandwidth to one node and a minimum of none 
to another. For example, a large database management processor in 
a network might be given a greater proportion of the bandwidth 
since it needs to send large amounts of data to other processors 
in the network. 

For total PCLll bus lengths in excess of 50 feet, the 
bandwidth is reduced as a function of the bus length. • 
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Multiple Units and Multiple Buses 

Additional flexibility and power are provided by the ability 
to put multiple PCL11 units on one processor and the ability to 
implement multiple bus systems. 

The use of two or three PCL11 buses to interconnect the 
processors can give increased reliability through redundancy as 
well as increased throughput. In the event of a failure disabling 
one PCL11 bus, the system would continue operation using the other 
bus. The use of dual bus systems is recommended for medium to 
large networks. 

In addition, a dual or triple bus system gives greater 
flexibility. For example, one bus could be heavily loaded with 
long data transfers while another bus is kept lightly loaded and 
used for command and control messages where quick response is 
desired. A third bus could be kept in reserve for backup. 

A processor can also have more than one PCL11 node .on the same 
PCL11 bus. The use of two nodes from the same bus can be used for 
processors having large amounts of traffic. The two nodes operate 
independently and concurrently, thus allowing for greater 
throughput on that processor. 

Building the System 

A PCLll network is a system constructed from several 
components that are combined to meet the particular application 
needs. 

A PCL11-B is the UNIBUS interface that contains the PCLll 
electronics and connects to the PCLll bus cable. One PCL11-B 
forms one node on the network. The PCL11-B interfaces are 
interconnected by cables of appropriate length to suit the site 
geometry. 
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Sample Applications 

The PCLll is successfully utilized in many different 
applications. The following are a few examples. 

Several customers implemented various forms of distributed 
database management and processing systems using the PCLll. 
Typical of these is one application consisting of several 
PDP-ll/40s, each managing a particular database and performing 
given functions. User terminals are connected to some of the 
processors. The application software is written to interpret the 
inquiry of command from the terminal and, if it is not one 
performed in that processor, to send the inquiry or command by 
using the PCLll to the appropriate processor for servicing. The 
response is generated and returned back to the originating 
processor and displayed on the user terminal. Thus, a distributed 
database is implemented by means of a virtual computer concept. 

Although the initial implementation of that system required 
only three processors, the software was designed in a modular 
manner for the general case so that as the application grows, 
additional processors can be added and part of the work load moved 
to them. The PCLll facilitates this expansion since all that is 
required to expand the network is to add another length of PCLll 
bus cable and another PCLll node. There is no need to rewrite the 
software or to rebuild the existing processors to allow links to 
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In another application, a high-energy nuclear physics research 
laboratory, a PCLll network is utilized to control large and 
complex instrumentation. Different processors are interfaced with 
certain portions of the facility and perform certain functions. 
The PCLll network permits an experimental run to be set up in 
minutes rather than hours as would otherwise be required. Thus it 
becomes an important contributor in the research for new forms of 
energy, 

In'a very large transaction processing network, 500 on-line 
terminals are serviced by 16 PDP-11/34 and PDP-11/70 processors 
acting as communications processors, transaction processors, and 
database managers. The processors are all interconnected by a 
dual PCLll network. The system is designed for high-availability 
and fail-soft operation. Each processor in the network backs up 
another processor in the network and receives duplicate data 
inputs. In the event of a processor failure, the data has been 
protected and the system automatically reconfigures itself for 
continued operation without interruption. 
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APPENDIX C 
DEUNA/DMP11/DMV11 Network Examples 
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Figure 20 Block Diagram of a Multipoint Network with Single 
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Figure 21 Block Diagram of a Multipoint Network with Multiple 

Tributary Addresses 
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Figure 23 Typical Full-Duplex Multipoint Local Network 
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Figure 24 Typical Half-Duplex Multipoint Network 
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Figure 25 Typical Large-Scale Ethernet Configuration 
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APPENDIX D 
DEUNA/DEQNA Ethernet Communications Controller 

DEUNA 

The DEUNA is a UNIBUS to Ethernet communications controller. 
It lets you connect VAX and UNIBUS-based PDP-11 computers to the 
Ethernet network. 

The DEUNA consists of two hex cards, distribution panel, and 
internal cabling. The DEUNA fits into two option slots on the 
UNIBUS backplane and connects to the H4000 transceiver using a 
transceiver cable. 



Table 15 DEUNA Features and Benefits 



Features 



Benefits 



32K byte (16K word) 
buffers in Random Access 
Memory (RAM) 

Independent Direct Memory 
Access (DMA) controller 

32-bit CRC error detection 

Down-line load and remote 
load detect 



Filters multicast addresses 
Gathers network statistics 
Internal microdiagnostics 



Provides data transmission 
and reception and handles 
maintenance-oriented datagrams 

High performance 



Ensures data accuracy 

Enables start-up of unattended 
nodes or nodes without local 
storage 

Reduce host processor load 

Aids in network maintenance 

Minimizes time to isolate and 
diagnose faults 



75 



DECnet-RSX ADDITIONAL NETWORK CAPABILITIES 



Backplane Power Checks and Preparation 



Perform the following operations on the backplane slots 
previously selected for DEUNA module installation. 

• With system power OFF, conduct resistance checks on the 
backplane voltage sources to ground to be sure that no 
short circuit conditions exist. 

• Turn system power ON. Verify the backplane voltages are 
within specified tolerances. 

• If present, remove the grant continuity modules. 

• If present, remove the Nonprocessor Grant (NPG) jumper wire 
that runs between backplane pins CA1 and CB1 on the slot 
selected for installation of the M7792 port module. 

NOTE 
If the M7792 port module is removed from the 
system, either replace the NPG jumper wire 
and install a G727 single-height grant 
module, or install a G7273 dual-height grant 
module. 

Device Address Assignment 

Assign the DEUNA a device address from the Input/Output (I/O) 
page of memory address space. The first DEUNA being installed in 
a system must be assigned the address 774510. For the second, and 
any subsequent DEUNA being installed in the same system, the 
device address must be selected from the floating address space of 
the I/O page. The device address is assigned by configuring 
switch pack E40 on the M7792 port module to the desired address. 
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First DEUNA Device Address (774510) — Assign device address 
775410 to the first DEUNA being installed in a system by 
configuring switch pack E40 on the M7792 port module as shown* 
Note that this address could overlap the twenty-third DP11 if 
present in the system. Refer to Figure 26 for the location of E40 
on the M7792 module. 



M7792 - E40 
SI S2 S3 S4 S5 S6 S7 S8 S9 S10 
OFF ON ON OFF ON OFF ON ON OFF OFF 



NOTE 
An OFF (open) switch responds to a logical 
one (1) on the bus. 
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Figure 26 M7792 Port Module Physical Layout 
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Second DEONA Device Address (Floating Address) — Assign a device 
address to the second (or subsequent) DEUNA being installed in a 
system by configuring switch pack E40 on the M7792 port module to 
the desired address determined from the floating address 
allocation. Refer to Figure 27 for the correlation between switch 
number and address bit. The ranking device address assignment of 
the DEUNA is 25. 
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Figure 27 Floating Address Assignment 
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Vector Address Assignment 

Assign the DEUNA a vector address from the reserved vector 
area of memory address space. The first DEUNA being installed in 
a system must be assigned the vector 120. The second (and any 
subsequent) DEUNA being installed in the same system must select 
the vector address from the floating vector area of reserved 
vector address space. The vector address is assigned by 
configuring switch pack E62 on the M7792 port module to the 
desired vector. 



First DEUNA Vector Address (120) — Assign vector address 120 to 
the first DEUNA in the system by configuring S1-S7 of switch pack 
E62 on the M7792 port module, as shown. Note that this vector is 
also used by the XY11. Refer to Figure 26 for the location of E62 
on the M7792 module. 

M7792 - E62 

SI S2 S3 S4 S5 S6 S7 

ON ON OFF ON OFF ON ON 



NOTE 
An OFF (open) switch produces a logical one 
(1) on the bus. 

Second DEUNA Vector Address (Floating Vector) — To assign a 
vector address to the second (or subsequent) DEUNA, configure 
S1-S7 of switchpack E62 on the M7792 port module to the desired 
vector determined from the floating vector allocation. Refer to 
Table 17 for the correlation between switch number and address 
bit. The ranking vector address assignment of the DEUNA is 47. 
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Figure 28 Floating Vector Assignment 
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Boot Option Selection (PDP-11 Host Systems Only) 

The DEUNA provides for remote booting and down-line loading of 
PDP-11 family host systems. These functions are switch-selectable 
by using two boot option select switches located on switch pack 
E62 on the location of E62 on the M7792 port module. 

When installing a DEUNA in a PDP-11 family host system, 
configure switches S8 and S9 on the switch pack E62 (M7792 module) 
for the boot function desired. Table 16 lists the switch settings 
and corresponding boot option functions. Refer to Figure 26 for 
the location of E62 on the M7792 module. 

When installing a DEUNA in a VAX-11 family host system, set 
both S8 and S9 on E62 (M7792 module) to the ON (disabled) 
position. 



NOTE 
An OFF (open) switch produces a logical one- 
(1). This is the enabled state of the switch 
function. 



Table 16 Boot Option Selection (M7792 E62 - S8 & S9) 

BOOT SEL 1 BOOT SEL Function 

Remote boot disabled 

Remote boot with system load 

Remote boot with ROM 

Remote boot with power up boot and 
system load 

Switch settings for a DEUNA installed in a VAX-11 system. 



ON* 


ON* 


OFF 


ON 


ON 


OFF 


OFF 


OFF 
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Self-Test Loop (for Manufacturing Use) 

The self-test loop is provided on the DEUNA for manufacturing 
testing. This is a switch-selectable feature that allows the 
on-board self-test diagnostic program, once it is initiated, to 
continuously loop on itself. This feature is controlled by S10 on 
switch pack E62 on the M7792 port module and should be disabled 
during installation. 

When installing a DEUNA, disable the self-test loop feature by 
setting S10 on switch pack E62 (M7792 module) to the ON (closed) 
position. Refer to Figure 26 for the location of E62 on the M7792 
module . 
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Figure 29 DEUNA to Ethernet Connection 
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DEQNA 

The DEQNA is a Q-BUS to Ethernet communications controller. 
It lets you connect Q-BUS systems, such as the LSI-I1, to the 
Ethernet network. The DEQNA provides data link layer and some 
physical channel functions for connection to Ethernet, 

The DEQNA consists of one dual module board plus the 
appropriate CPU kit that consists of a distribution panel, and 
internal cabling. The DEQNA controller board fits into an option 
slot on the Q-BUS backplane and connects to the H4000 Transceiver 
using a transceiver cable. 

The DEQNA has all the features of the DEUNA device. It 
supports the LSI-11 or Q-BUS based CPU's: PDP-11/03, PDP-11/23A, 
PDP-11/23-PLUS, PDP-11/23S, and the Micro PDP-11 with DECnet Phase 
IV software. 
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EXERCISES 



For each of the items find the appropriate definition, 
item may be used more than once or not at all. 



Each 



1. 


CETAB.MAC 


2. 


HLDTAB . MAC 


3. 


SLD 


4. 


HLD 


5. 


Multipoint 


6. 


Ethernet 


7. 


Tributary 


8. 


RSX-11S 


9. 


NCP 


10. 


CFE 



a • 



b. 



c. 



d. 



A network topology where there 
is one line and up to 12 nodes 
connected to that line. 

The task that acts as the LDR 
task on stand-alone DECnet nodes. 

A network topology where all nodes 
are considered adjacent. 

The task that maintains the 
volatile down-line system loading 
database. 

The server task for down-line 
task loading. 

The permanent database for task 
loading . 



The node that controls polling on 
a multipoint topology. 
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SOLUTIONS 

For each of the items find the appropriate definition. Each 
item may be used more than once or not at all. 



1. 


CETAB . MAC 


2. 


HLDTAB.MAC 


3. 


SLD 


4. 


HLD 


5. 


Multipoint 


6. 


Ethernet 


7. 


Tributary 


8. 


RSX-11S 


9. 


NCP 


10. 


CFE 



a • 



b. 



c. 



d. 



e. 



f . 



A network topology where there 
is one line and up to 12 nodes 
connected to that line. 



The task that acts as the LDR 
task on stand-alone DECnet nodes. 

A network topology where all nodes 
are considered adjacent. 

The task that maintains the 
volatile down-line system loading 
database. 

The server task for down-line 
task loading. 

The permanent database for task 
loading • 



g. none The node that controls polling on 
a multipoint topology. 
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LAB EXERCISES 



1. Set up a node in your volatile database that can be down-line 
system loaded to a designated satellite computer with an 
available RSX-11S operating system. 

2. Down-line system load the satellite using the database created 
in Lab Exercise 1. 






DECnet-RSX ADDITIONAL NETWORK CAPABILITIES 

SOLUTIONS TO LAB EXERCISES 

1. See Example 1 



2. NCP LOAD NODE REM SYS VIA UNA-0 

OR 
NCP TRIGGER NODE REMSYS 
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DECnet-RSX INTERNALS 

INTRODUCTION 

DECnet-RSX is implemented as a layered product on top of the 
RSX-11 operating system. The Communication Executive (CEX) 
shields the DECnet software from the RSX-11 Executive. CEX 
manages communication processes, tasks, and buffers for DECnet. 
An end user accesses the communication software by issuing QIO 
calls to pseudodrivers (NS: for logical link, NW: for PSI, and 
X: for DLX) . 

Communication processes are divided into three categories: 

• Logical Link Control (LLC) 

• Data Link Control (DLC) 

• Device Driver Module (DDM) 

Processes communicate with each other using communication 
control blocks, which are small data structures allocated out of 
the Dynamic Storage Region (DSR) . Communication control blocks 
contain information on the status of a current data packet that 
DECnet software processes; for example, received or transmitted, 
which process owns the packet (ECL, XPT, or DMC) , whether the 
packet comes from LLC to DLC to DDM and so on. 

Pseudodrivers (NS:, NW: , and NX:) are implemented as 
communication processes, and some of them, particularly NS: and 
NW: , have corresponding ACP tasks (NETACP for NS: and X25ACP for 
NW:). ACPs essentially process most complicated requests; for 
example, NETACP contains a session control mechanism used for 
creating the logical link; X25ACP processes the interrupt calls 
on a virtual circuit. One may view the NS:-NETACP (and 
NW:-X25ACP) pair as a team that processes fast network requests in 
the driver and slow network requests in the ACP. So SND/XMT and 
REC/RCV data over the existing logical links/virtual circuits are 
processed in the NS:/NW: because those requests are logically 
faster than CON/CAL, for example. 

CEX contains a module, Communications Executive Common 
(CEXCM) , that is essentially a set of global pointers to the 

DECnet software. CEXCM also points to the Configuration Database 
(CETAB) that reflects a particular node configuration (types of 

lines, processes generated by NETGEN and so on). 

CEX, communication processes, buffers, and CETAB are loaded to 
the system by the Network Loader (NTL) task that reads the 
CETAB. MAC file. The standard RSX-11 loader is not used. 

This module covers major components, data structures, and data 
flow for the DECnet-RSX software. 
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OBJECTIVES 

Upon completion of this module, the specialist should be able 
to : 

• Specify major components of the DECnet-RSX software. 

• Identify the functions of the major components and data 
structures. 

• Understand the general data flow in the DECnet-RSX 
software. 

RESOURCES 

1. DECnet-RSX Network Generation and Installation Guide 

2. DECnet-RSX Overview 

3. DECnet-RSX Release Notes 
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COMMUNICATIONS EXECUTIVE (CEX) 

• Set of modules that help communication processes run. 

• For /M-PLUS, it resides in the CEXBF module erf the RSX 
executive (code starts at $CEX::). For /M/S. it resides in 
DSR (in CEXPAR by convention) . 

• It provides: 

Interprocess communication routines — To allow 
processes to communicate with one another 

Process scheduling routines — To allow processes to 
schedule other processes for execution 

Buffer management routines — To allocate/deallocate 
main memory buffers from available buffer pool 

Timer support routines — To provide processes with 
logical timers 

- Modem control routines — To support modem handling for 
lower-level processes (resident in AUX process) 

Set of common routines — To be used by communications 
processes 
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COMMUNICATIONS PROCESSES 

• Logical modules of the DNA 

• Event-driven sequential processes (with the exception of 
handling interrupts from the hardware) 

• Processes can be scheduled by the CEX and, if necessary, 
suspended with their context saved 

• Processes are not reentrant and do not share databases 

• Processes communicate with one another in the following 
way: 

- A sending process creates an interprocess communication 
message. 

Such a message is placed by the CEX in the destination 
process 1 queue. 

The destination process is scheduled for execution by 
the CEX. 

• Processes are channel-oriented 

A channel is an entity that a given process performs a 
specific function on (for example, for a device 
handler, a channel is generally one device, or possibly 
many identical devices; for ECL, a channel is a 
logical link) . 

• A process performs certain functions on a channel, and if 
there is more than one channel, the process handles each 
channel identically but independently from all other 
channels 

• The implications of channel-oriented communications 

Most processes have a separate database for each 
channel they handle. Each database is identical in 
format to the databases of all other channels handled 
by the same process. 

When a process is scheduled, it is generally requested 
to perform a service for only one of the channels that 
it handles. That is, each element or interprocess 
communication message that drives a process generally 
requests a service on only one channel. 
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• Types of Processes 

Logical Link Control (LLC) 

AUX - Auxiliary Process 

EVL - Event Logger 

ECL - End Communications 

XPT - Routing Process 

DLX - Direct Line Access 

NW - X. 25 Access Process 

PLI - Packet Level Interface 
- Data Link Control (DLC) 

DCP - DDCMP Process ^, ^>>* 

LAB - LAB Protocol Process 

EPM - Ethernet Protocol Manager ,c .^fe 
Device Driver Module (DDM) 

DMC - DMC-11, DMR-11 Device Driver 
. DMP - DMP-11 Device Driver 

DUP - DUP-11 Device Driver 

PCL - PCL-11 Device Driver 

DLM - Data Link Mapping Driver 

• Each process is less than 4 Kw and is mapped to by KAPR5 
when required. 

• Specific processes can be included in or excluded from the 
running system if needed. 

• On the PAR display or crash dump, the processes are shown 
as dynamic subpartitions in a form of NT. XXX, where XXX is 
a process name (for example, NT. AUX for AUX; NT. XPT for 
XPT) . 
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LLC Processes 

• Auxiliary Process (AUX) 

Non-time-critical extension of the CEX 
Functions 

Buffer allocation failure recovery 

Powerfail recovery 

Modem control 

Timer services 

Fork processing and process dispatch 

Allocation/deallocation of buffers in network pool 
(POOL..) 

• Event Logging Process (EVL) 

Creates records of network events 
Dispatches the events to local or sink nodes 

• End Communications Layer (ECL) 

Accepts QIO requests from user tasks for logical links 
(NS: driver) 

Processes these requests (SND$, REC$, XMI$) or gives 
them to NETACP for processing (all other calls) 

Contains time-critical code for logical link processing 

Implements the NSP protocol 
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Routing Layer (XPT) 

Contains time-critical code for routing processing 
(contains a copy of Reachability Vector and Adjacency 
Block and a copy of Minhop/Mincost vector) on routing 
type nodes. 

Manages communication between DLCs and LLCs 

Implements the routing protocol 

Direct Line Access Process (DLX) 

Accepts and processes QIO requests from user tasks for 
DLX access (NX: driver) 

NW: Driver for X. 25 Access Process (NW) 

Accepts QIO requests from user tasks for X. 25 access 

Processes these requests (XMT$, RCV$) or gives them to 
X25ACP for processing (all other calls) 

Packet Level Interface (Level 3 protocol) Process (PLI) 

- Implements the X. 25 Level 3 protocol 

Processes requests from NW: and X25ACP originated by 
user QIOs 

Provides for transmissions and reception of data 
packets and controls virtual circuit processing 
(multiplexing virtual "circuits on a physical line, 
allocation/deallocation of logical channel numbers) 
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DLC Process 



Provides sequential, error-free data transmission and 
reception on the physical link 

Primary functions 

Starts/stops the physical line 

Provides the frame-level protocol for data to be 
transmitted and supervising the transmission of data 
over the line 

Decodes the frame-level protocol in supervising the 
reception of data over the line 

Examines/changes line characteristics (line services) 

Provides special conditions notification to 
higher-level processes 

DDCMP Control Process (DCP) 

Implements DDCMP for devices other than those that can 
provide microprocessor-based DDCMP support 

- Contains the polling algorithm for multipoint 
operations on devices other than the PCL11-B, DMP11 and 
DMV11. 

LAP-B Protocol Handler (LAB) 

Implements the X. 25 Level 2 protocol 

- Required for DUP11 and DPV11 if used for PSI 
environment 

Transmits and receives data for PLI 

Supports the trace function 

Ethernet Protocol Manager (EPM) 

Implements the Ethernet protocol 

- Required for DEUNA or DEQNA devices 
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DDM Process (Except DLM) 

• I/O handler for a communication device (s) 

• Executes as a result of either a device interrupt or an I/O 
request from a DLC 

• Primary functions 

Starting and stopping the device 

Giving the device buffers to receive and transmit 

Retrieving/setting device characteristics 

- Terminating the current operation (transmit or receive) 
on the device 

- Providing special notifications to higher-level 
processes 

Data Link Mapping Process (DLM) 

• Pseudo DLC/DDM process that allows for DECnet data to be 
sent over the X.25 network 

s j.mpa.3uienta t ion as an interface between tuc ^outing anu cux 

• DECnet views the DLM as a process that drives a multipoint 
line (up to 64 stations per controller, up to 4 
controllers) 

• ECL adjusts its segment size to the PLI packet size, so 
that a long message may be sent as a number of PLI packets 

• A CRC-16 field is added to ensure error-free transmission 
over X.25 circuits 
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MAJOR TASKS 
Network Loader (NTL) 

• Performs loading and unloading network components by 
reading the CETAB.MAC file 

• Allocates/deallocates process-related data structures 

KMC Microcode Loader (KMCL) 

• Loads KMC microcode during system initialization for only 
11-S systems or after powerfail (NTL loads microcode upon 
system initialization for M, M-PLUS) 

• Used for KDP, KDZ , and KMX devices 

General Microcode Loader (MDL) 

• Loads Ethernet devices with proper microcode 

• Required for DEUNA and DEQNA devices 

Network Initializer (NTINIT) 

• Performs initialization functions on the node when the 
network is turned on: SET SYS, SET EXEC STATE ON, and SET 
MOD X25-SERVER STATE ON 

Event Collector 

• Server task for the EVL process 

• Dispatches event records to a file, terminal, or 
user-written monitor task 

• Transmits the events to a specified sink node by using a 
logical link to Event Receiver Task (EVR) 
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DECnet Network ACP (NETACP) 

• Works in conjunction with NS: (ECL) 

• Processes user QIO requests from NS: for logical link 
(other than (SND$, REC$, XMI$) that are processed by the 
NS: itself) 

• Accomplishes incoming calls by requesting tasks for them 

• Notifies user tasks when network events occur 

• Contains session control routines 

Routing Control Processor (RCP) 

• Performs routing protocol functions for the DECnet 
functions for the DECnet routing type node 

• Maintains the routing database 

• Monitors circuits for down-line load, up-line dump, and 
circuit loopback tests 

X=25 Network AGP (X25AGP) 

• Works in conjunction with NW: and PLI 

• Accomplishes connect and disconnect calls as well as 
incoming calls for user tasks 

• Notifies user tasks when network events occur 

Network Control Program (NCP) 

• User interface to the Network Management Layer 

• Provides parsing functions for user QIO requests before 
giving them to the local NM: driver or remote NICE task 
(by using logical link) 

• Contains dispatch tables for processing the commands, thus 
coordinating the commands' execution 
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Network Management Device Driver (NMDRV) (NM:) 

• Provides initial checking for given NCP or NICE requests 

• Gives valid requests to NMVACP for processing 

Network Management Volatile ACP (NMVACP) 

• Executes NCP or NICE commands per requests from NM: 

• Makes changes to volatile database only 



^ Odd \roor*§ 
Network Information and Control Executor (NICE) (NIC$$^task) 

• Serves network management requests from remote nodes 
(Object 19) 



Event Receiver (EVR) 

• Receives events from remote nodes and dispatches them to a 
terminal, a file, or a user-written monitor task (MON. . . 
by default) 

Other Tasks 

• A set of privileged and nonprivileged tasks that are not as 
vital for the DECnet running as specified previously. 

• They perform user interface functions for specific 
applications (for example, file transfer, down-line task 
loading, remote terminal facility). 

• They use primarily the logical link facility so they can be 
grouped into pairs. 



i 
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BUFFERS 

• Communications Control Blocks (CCBs) 

Obtained from the remaining space of CEXPAR, if 
available,- or DSP- 
Used for interprocess communication 

• Network Buffer Area (POOL..) 

Contains various buffers and some of the data 
structures for DECnet and PSI 

- Allocated dynamically on network loading 

• Small Data Buffers (SDBs) 

- Used for protocol or task control messages 
Obtained from the network buffer area (POOL..) 

• Large/Receive Data Buffers (LDBs/RDBs) 

- Obtained from POOL.. 

System Buffers for data communication over a network 

- Each LDB/RDB is pointed to by a corresponding CCB 

- Certain number of RDBs are reserved only for receiving 
data (receive threshold - congestion control) 
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Figure 1 Integration of Network Components 
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RSX/NETWORK INTERFACE 

• Network programming is implemented as a standard RSX QIO 

intcriuCc « 

User task issues QIO to a device driver by specifying 
Logical Unit Number (LUN) for the driver in the I/O 
call 

- I/O packet created by DRQIO routine in RSX executive is 
given to the driver or ACP based on function mask in 
the driver's DCB 

Control returns to the user tasks by using $DIRXT: : in 
SYSXT module of the RSX executive 

• The following pseudodevice drivers support network I/O 
operations: 

NS: driver — Provides I/O interface for logical link 
facility; it is implemented in the ECL process 

NW: driver — Provides I/O interface for PSI facility; 
it is implemented in the NW process 

NX: driver — Provides I/O interface for direct line 
access facilit v/ ; it is implemented in the DLX process 

• These drivers contain standard RSX-like entry dispatch 
tables. They have associated with them DCBs , UCBs , SCBs , 
and code f but they contain no interrupt service routines 
because they do not drive any hardware. (Hardware 
interrupts for communication devices are handled by the 
corresponding DDM processes: DMC, DUP, DL, UNA.) 

• Such a structure allows shielding of the network software 
from the RSX executive. 

• DCBs, UCBs, and SCBs for NS : , NW:, and NX: are created by 
the NTL task on loading the network. The standard RSX LOAD 
command is not used. 
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Figure 2 • General Data Flow 



Notes on Figure 2 



o 



1. Direct call means that the current process gives a CCB to 
the next process to be run for that CCB and schedules that 
process for execution through the CEX. 



2. Queued means that the I/O packet is given to ACP by using 
the ACP's receive queue in the task's header. 

3, Queued to fork means that a CCB is queued by the current 
process to the end of the network fork queue and it will be 
dispatched to the next process by the network fork 
processing routines (resident in the AUX process) . Network 
fork processing routines are activated by the RSX executive 
(SYSXT) the same way as any standard fork processing 
routines . 



4. All incoming messages are dispatched by the 
processing routines (see item 3 for details) 



network fork 
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DETAILS OF THE RSX-11 /NETWORK INTERFACE 

• The QIO directive is accomplished by: 

- $EMTRP in DRDSP 

- $DIRSV in SYSXT 

- $DRQIO in DRQIO 

The I/O packet is either passed to the ACP or passed to the 
driver's initialization routine. If passed to the ACP, the 
ACP's Stop bit is unset. 

Control is then returned to the user task by using $DIRXT 

in SYSXT. 

» 

• The determination of whether a function goes to the ACP or 
the driver is done in DRQIO by examining the function code 
mask of the driver in the corresponding DCB. 
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Figure 3 DCB Offset Definitions 
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Device Function Mask for NS: 



For Functions 
20-37 



For Functions 
0-17 



(Obtained from system crash dump) 



Legal 

Network control 



037000 



000001 



Disconnect from process 



Connect to process 

Receive message process- 
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I/O request 



ACP 

Network ACP 
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No Files-11 
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Non-ACP 
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Cancel I/O request required by the device for aborting the task. 



Device Function Mask for NW: 



For Functions 
20-37 



For Functions 
0-17 



(Obtained from system crash dump) 
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Network control' 
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000001 



Disconnect from process 
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Receive message process 



Transmit message process 

Control 037000 

No-op 000000 
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Cancel 

I/O request 



000001 
000000 
000000 



Network ACP 
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No Files-11 
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Device Function Mask for NX: 



For Functions 
20-37 



For Functions 
0-17 



(Obtained from system crash dump) 
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All the QIO calls are given initially to the drivers (NS:, 
NW:, and NX:) for initial checking. Then the driver may 
request ACP processing for an I/O packet. 

QIO calls to NS: that do not require NETACP processing 
are SND$, REC$ and XMI$ 

QIO calls to NW: that do not require X25ACP processing 
are XMT$ and RCV$ 

QIO calls to NX: do not require ACP processing at all 
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• I/O function codes for the network pseudodrivers 

- NS: 

SND/XMI (FC=31) 

REC (FC=32) 

CON/ACC (FC=33) 

DIS/ABT/REJ (FC=34) 

OPN/CLS/SPA/GND (FC=35) 

- NW: 

XMT/RES/INT/ICF (FC=31) 

RCV (FC=32) 

CAL/CAC/APV (FC=33) 

CR J/CTR/CLR/DPV ( FC=3 4 ) 
OPX/CLX/SPX/GNX/TDN (F035) 



- NX: 



IO.XOP (FC=33) 

IO.XCL (FC=34) 

IO.XIN (FC=35) 

IO,XTM (FC=31) 

IO.XRC (FC=32) 

IO.XHG (FC=36) 



I/O flow 



20 



DECnet-RSX INTERNALS 



SYSTEM 



DEVICE DRIVER 

$NSTBL::OR 
C $NWTBL::OR 

SNXTBL:: «*— 



DRQIO 



DRDSP 



DEVICE DRIVER 
PROCESSING 



<- RETURN 



JJ 



iTL 



SDRQIO: 

■$DRQRQ: 
'RETURN 



SEMTRP: : -. 



CALL@{SP)+ 



► RETURN- 



TRAP VECTOR i 



', USER TASK 



SYSXT 



DPB 



SDIRSV: : 
-CALL{R5) 



=*>BR$DIRXT 

r^SDIRXT: : 

' I FORK ' 
1 PROCESS 
I CALL 



RTI 



1JU 



EMf 377 

i 

I-. 

I 

! 

I 
I 
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Figure 4 I/O Flow from the User Task to the Device Driver 
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NETWORK DATA STRUCTURES 

• All the DECnet data structures are described in NETLIB.MLB 
and can be retrieved by using LBR utility: 

LBR TI:=DM0: [130, 10]NETLIB. MLB/EX: xxxxx 

• For PSI data structures, use PSI.MLB: 

LBR TI:=DM0: [1 , 1] PSI .MLB/EX: xxxxx 
where 

DM0: is a device for the network distribution 

xxxxx is the name of the macro for a specific structure 

• There are several databases in the system that point to all 
other data structures 

- SYSCM — RSX executive database (module in RSX 
executive) 

CEXCM — Communications Executive database (module in 
CEX) . For DECnet-llM-PLUS, the module's name is NETCM 

DDB — ECL database (allocated from DSR on loading the 
network) 

- SESDAT — NETACP database (module SESDAT in NETACP) 

PHB — PSI home block (allocated from DSR on loading 
the network) 

PLI database (allocated from DSR on loading the 
network) 

- X25ACP database (module in ACPROD for X25ACP) 

• The following databases can be found from NETLIB.MLB or 
PSI.MLB 

- DDB — NETLIB.MLB, macro ECDDB$ 

- PHB — PSI.MLB, macro PHBDF$ 

- PLI database — PSI.MLB, macro PLIDF$ 

• The remaining databases can be retrieved from the 
corresponding source listings 
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Figure 5 CEX Database (CEXCM) - CETAB 
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Figure 6 Major RSX-Ii PSI Data Structures 
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Figure 7 General Picture of Logical Link Operations 
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Figure 8 General Picture of Virtual Circuit Operations 
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Appendix A contains details of connections between various 
data structures. 

Appendix B contains a summary of the data structures for 
DECnet and PSI as well as offset definitions. 



DETAILED SYSTEM FLOW 



Interprocess Communication 

In general, one communication process communicates with 
another by sending it a CCB. The CEX contains routines that place 
the address of a specified CCB in the queue that drives a 
particular communication process. These routines may also 
dispatch the destination process immediately or queue it. for 
subsequent execution. 

In addition to the use of CCBs for interprocess communication, 

the CEX contains routines that allow one process to send the 

contents of a single register to another process for selected 
special functions. 

Process Scheduling 

A major function of any executive, including the CEX, is to 
provide mechanisms for scheduling the orderly execution of 
processes. Communications processes running in the environment 
provided by the CEX and the RSX-11 operating system can schedule 
other such processes for execution using the following mechanisms: 

• At the operating system's fork level through the fork-level 
or clock queues 

• Immediately, through a process dispatch operation 
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Fork-Level Process Scheduling 



The CEX provides routines to allow commun 
append a CCB (chain) to a CEX-internal fork 
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Figure 9 Fork-Level Process Scheduling 
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TIMER SUPPORT 

Timer Process Scheduling 

The CEX provides timer support functions for any processes 
that require them. There are two separate types of logical timers 
managed by the CEX: 

• 100-millisecond resolution (one-shot) timers — Used by 
processes to cause single events to occur or to dispatch to 
other processes, one time only, at the end of a relatively 
short time period. 

• One-second resolution (repetitive) timer — Used by 
processes to schedule events and dispatch to other 
processes on a periodic (one second) basis once a 
relatively long time period has elapsed. 

100-Millisecond Timers 

Processes requesting a 100-millisecond timer calls a CEX 
routine to place a logical timer call in a list kept by the CEX. 
This four-word cell (see CEX routine $STSTM) contains the number 
of 100-millisecond units to initialize the timer- and the process 
to execute when the timer runs out. The CEX posts a 
100-iuilliseconu timer request to the operating system so that the 
CEX timer processor is queued for fork-level execution once the 
100-millisecond period has ended. When executed, this 
timer-processing routine decrements each timer in the CEX queue 
and executes the process specified in the timer queue entry when 
the timer has expired. The timer entry is then deleted from the 
list. 

One-Second Timers 

The CEX cooperates with the operating system in another way to 
provide processes with one-second timers. When the CEX is loaded 
and initialized, the Network Loader (NTL) posts a one-second timer 
request to the operating system with the CEX one-second timer 
processor as the timeout routine (which is executed at fork 
level). This CEX timer processor always posts another timer 
request to the operating system and is therefore self-propagating. 
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After servicing the system lines, the timer processor scans 
the Process Descriptor Vector (PDV) table for processes that 
require timer support and execute those that request it. This 
type of support involves no timer cells and is repetitive as long 
as the process timer support flag bit is set. 
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Figure 10 Time-Dependent Process Scheduling 
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"Modem Control Services 

Another facility that the CEX provides is a general modem 
control service for both synchronous and asynchronous lines. This 
service is transparent to communications processes and removes the 
burden of modem control and mod em/ line state handling from them. 
Hence processes need only be concerned with the following 
line-related control functions: 

• Wait for ring 

• Enable line 

• Disable line 

When a process sends one of these requests to another process 
(DLC to DDM, for example) by utilizing the CEX process dispatching 
routines, the CEX delays the dispatch long enough to perform . some 
modem control bookkeeping. 

In addition, the CEX monitors all active lines at one-second 
intervals by dispatching to their DDM processes' "modem sense" 
entry points. Each of those DDMs returns modem status information 
to the CEX, which uses that data to update its own modem control 
table. If the status (state) of the modem changes since the last 
monitoring interval ended, the CEX executes an internal modem 
control routine to service the new modem state. 

This service usually involves the notification of the line's 
DLC process in situations such as ring detects, line failures, and 
the disabling of inactive lines. 

Mapped System Support 

When the CEX starts a process in a mapped system, it 
guarantees that memory is mapped as in Figure 11. 

This mapping structure imposes a limitation on the size of an 
individual communication process to 4K words. For those 
situations where a process needs more address space, CEX routines 
exist to provide a simple overlay capability to the process. With 
this capability, the extra address space can reside in auxiliary 
4K processes that can be overlaid on the original process 1 virtual 
address space. The overlaid process context (mapping) is saved 
and restored after the auxiliary process exits. Since the system 
stack is used to save the context, the overlay process may be 
nested several times. 
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Figure 11 Process Address Space Mapping 
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Figure 12 RSX-11 Mapping for DECnet 
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Figure 13 RSX-11M-PLUS EXEC Layout 
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Event Logging Services 

The CEX provides an event-logging interface routine for 
communication processes (see CEX utility routine $CELOG). The 
requesting process passes to the CEX routine the event control 
information and an event description so that the CEX can dispatch 
the LLC process that performs all network event logging. When the 
event has been recorded, the control is returned to the requesting 
process . 
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Figure 14 Details of Event Logging Services 
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Network Management Processing 
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Figure 15 NCP-NICE Processing 
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ACP PROCESSING 
NETACP Processing 

Initialization is done upon: 

NCP> SET EXEC STATE ON 

or 

VNP> SET EXEC STATE ON 

NETACP is in the main loop state for CCBs and I/O packet 
processing. CCBs are high priority. When NETACP is idle, it sets 
the Stop bit. Whenever NETACP processing is required by ECL, the 
Stop bit is unset and NETACP is ready to process the request. 
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Figure 16 NETACP Initialization and Main Loop 
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Flow Control Processing 

Processes described in this section are: 

• Route-through 

• Packets coming from ECL to the network 

• Connect initiate processing 

• Data subchannel and other data subchannel 

• Timers and acknowledgments on a logical link 

Route-Through Traffic 

When a CCB is given to XPT by the lower level processing (for 
example, DCP or DMC by using CEXCM scheduling and mapping done by 
CEX) , it is time to check if RDB (which is associated with this 
CCB) contains the local node number as a destination address. If 
it does, this packet is passed to ECL. If not, the CCB is mapped 
by the Reachability Vector through the Adjacency Block. The 
Adjacency block contains information about each adjacent node to 
the PLD that has the lowest circuit cost to the destination and 
queued there in P$FWD (the store and forward queue) . 

If the destination node is unreachable and the flag Return to 
Sender is set in the packet's routing header, this packet will be 
sent back to the sender; if the flag is unset, the packet is 
discarded. 

XPT checks if the limited visits threshold is exceeded and, if 
it is, XPT discards the packet. XPT discards the route-through 
packet if the square root limit that regulates channel workload 
and buffer availability is exceeded. 



Number of Buffers 



square root limit = 



Number of Active Circuits 
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End Traffic Handling 

PLD has an Input Packet Limiter (PC$IPL) that regulates the 
number of packets that XPT can queue to a channel at any given 
time (default is 6). This mechanism, together with the square 
root limiter, optimizes network performance; route-through 
packets receive higher priority to use the local node's resources 
compared with ECL packets. 

When you issue SND$, the I/O packet is stored in the window 
block reserved for the LUN that you specified in the CALL. ECL 
then allocates an LDB, loads it with data from the user task, and 
gives it to XPT. XPT checks if the ECL Input Packet Limit 
(PC$IPL) is not exceeded and, if not, places the corresponding CCB 
to the end of the PLD's store and forward queue. There is no 
checking of this type for REC$ and XMI$ macros because they do not 
allocate LDBs, but rather use SDBs and, as a result, do not share 
resources with route-through traffic. If ECL cannot allocate 
system resources for the I/O packet (for example, no LDB or SDB 
available) , it tries to do that again a few times (5 is default) . 

Two mechanisms are involved with this type of retrying: the 
one-second timer that requests CEX to reschedule ECL, and 
completion of processing a request by ECL. 

Connect Initiate Processing 

The Connect Initiate request is always sent with a Return to 

Sender flag which means if the destination node is unreachable for 

some reason the packet will be returned to the original node. The 

Connect Initiate timer is set by default to 32. seconds. If ECL 

did not get the CIACK by that time, the CI message is 
retransmitted. The retransmission threshold for Connect Initiate 

is equal to 5 (default). When it is exceeded, the connection is 
rejected by the ECL (completion code IE.NRJ in CON$). 
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Data Subchannel and Other Data Subchannel 

Normal and interrupt data are transmitted by using the same 
logical link, but there are actually two separate subchannels: 
data subchannel and other data subchannel • 

On the receiving side, CCBs associated with RDBs in which 
incoming messages have been stored are placed into the fork queue 
processed by AUX in FIFO order. 

CCBs with interrupt data are placed into the NETACP queue for 
processing. CCBs with normal data or link service are processed 
by ECL that reloads data from the RDBs to the corresponding user 
task's buffers. 

When NETACP processes the interrupt data CCB (which always 
happens before control is returned to the user task) based on the 
function code in the CCB (which was previously loaded into the CCB 
by ECL), it queues this CCB to the user task's mailbox queue. 
NETACP then executes a special routine, ADDMAI. 

ADDMAI:: in SESSUB is used for any event that requires 
queuing the CCB to the task's mailbox data queue. This mechanism 
forces the user's task to execute an AST service routine that 
contains the request Get Network Data (GND) from the mailbox queue 
before continuing. 

The user task always starts checking the mailbox to see if 
anything was stored there by NETACP. 
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Timers and Acknowledgements on a Logical Link 

Whenever ECL sends data from the node, it starts the 
round-trip timer. The threshold for this timer for Connect 
Initiate (CI) messages is defaulted to 10 seconds. The time from 
sending the CI message until processing CIACK by ECL on the local 
node is considered to be the current round-trip timer threshold 
over the particular logical link. If this threshold is exceeded, 
ECL retransmits the packet. The number of times for 
retransmission is defaulted to 5. 

When the logical link is established, it is ready to send and 
receive messages by the tasks on both sides. The message flow 
control mechanism is used by both ECLs. The algorithm of control 
is as follows: 

• The receiving side issues the Link Service message that 
contains the request: "I have a buffer for you, send me a 
message." 

• The sending side divides its message into segments (size of 
the segment is defined by the CI-CC process over the 
logical link) and begins to send it segment by segment. 

• The sending side expects to receive a Data ACK for every 
message sent out. The logical link table keeps track of 
time and the 

• Each message has a number associated with it; that is, the 
receiving side sends Data ACK for message 1, message 2, and 
so on. If the message arriving at the receiving side 
contains the message number out of sequence, the receiver 
drops the message and sends Data NAK for the last correct 
message's number. 

• On the sending side, the timer is reset when Data ACK/NAK 
is received for the message number that was sent with 
starting of the timer. 

• If the timer expires, the sender retransmits the message. 
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Fork Processing 

The entry $CMFRK: : in CEXCM describes the format of the fork 
block for DECnet. It is different than normal RSX-11M fork block 
format: 



$CMFRK: : .WORD 
.WORD 
.WORD 



Link 

Fork processes routine 

List head of CCBs 



This fork block is linked to the chain of the fork blocks for 
RSX-11M $FRKMD: : and is called by $DIRXT: : (the SYSXT module in 
RSX-11M) on any directive exit. 

The prestored fork process routine address is the $SQSRV: : in 
the AXSCM module of AUX. 

If a CCB has a mask (for example, from DLC to LLC process) , 
then according to that mask, AUX dispatches the CCB to the LLC 
process by CALL $PDDSP. 

Once AXSCH takes control, it dispatches all CCBs in the fork 
queue before exiting. 
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APPENDIX A 
Correspondence Between DECnet Data Structures 



These structures are in addition to those discussed in the 
module. 



XPT 

PDV 
ENTRY 



XPT 
DATABASE 



ADJACENCY 
DATABASE 
PART 1 



ADJACENCY 
DATABASE 
PART 2 



XPT 

LINE 

CNTRS 



TRACE 

COLLEC. 

TCB 



XPT 

NODE 

CNTRS 



RCP1 
TCB 



LEVEL 1 

CCB 

QUEUE 



REACH- 
ABILITY 
VECTOR 



MINHOP/ 
MINCOST 
VECTOR 



Nl 
CACHE 



PASSWORD 
DATABASE 
DESC. 



RCP2 
TCB 



LEVEL 2 

CCB 

QUEUE 



PLB 

VECTOR 

TABLE 








PLB 
ENTRY 














PLB 
ENTRY 










ETC. 









AREA 

REACH 
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MINH/C 

VECTOR 
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Figure 18 XPT Databases 
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Figure 19 ECL Databases 
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Figure 20 PLD and SLT 
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Figure 21 SLT and DDM Line Table (DMC) 
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Figure 22 User Task Header, Network Data Queue, 

and Window Blocks 



DECnet-RSX INTERNALS 



SYSCM/RSX 
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Figure 23 NS: UCB and VCB 
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LLT/DSR 



ULA (WND) 



CHANNEL* 



LLATADDR 



REM LL# 



LOCAL LL# 



CI/CC QUE 



REM NODE* 



ECL COUNT 



L 



ECL COUNTERS 
IN POOL.. 



NS:VCB 



V.ULT 



V.ULTE 
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DSR 
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LLAT/DSR 



C.BUF 



^C 
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Figure 24 LLT, Window Block, and Mailbox 
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APPENDIX B 
Data Structure Summary and Offset Definitions 

Data in Comm/Exec/RSX Pool 

Within the Comm/Exec partition is the Comm/Exec pool. The 
size of the Comm/Exec pool is determined at Network Generation 
time. The following data structures are located in either the 
Comm/Exec pool or the system pool (DSR) . Both are mapped in the 
Executive virtual address space. 

NOTE 
The Comm/Exec pool is not available for data 
structures in RSX-11M-PLUS systems with I/D 
space. The Comm/Exec resides in I space 
provided by the RSX executive. 
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DHBDF$ - DECnet Home Block Format 

The DECnet Home Block contains DECnet specific information 
that is accessed by multiple DECnet processes and/or tasks. The 
DECnet Home Block is allocated from RSX system pool (DSR) and is 
pointed to by using a $DECPT in the Comm/Exec Common. The DECnet 
Home Block can be examined in a running system by using the CEDump 
/DH switch. 



ALIAS NODE NAME LISTHEAD 


. DSANN 


REMOTE NODE NAME LISTHEAD 
POINTER TO END 


D$RNN 


LOCAL NODE NAME (6 BYTES) 


D$LNAM 


LOCAL NODE NUMBER 


DSLNUM 


IDENT STRING LENGTH 
LOCAL NODE IDENTIFICATION 
(32 BYTES) 


D$LID 


HOST NODE ADDRESS 


D$HOST 


HIGH-ORDER FOUR BYTES OF 
ETHERNET ADDRESS 


DSHIOR 


NUMBER OF ROUTING CHANNELS 


D$NLN 


DLL SERVICE DATABASE ADDRESS 


D$SER 


DLL DATABASE FNB ADDRESS 


D$FNB 


ECL SEGMENT SIZE 


DSSEG 
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Figure 25 DECnet Home Block (Sheet 1 of 2) 



52 



DECnet-RSX INTERNALS 



The following Home Block cells are present for 
only: 



routing nodes 



lUJM^CIN^ICO 



NUMBER OF BROADCAST END NODE ADJACEN'S 



NUMBER OF NODES IN NETWORK 



NUMBER OF AREAS IN NETWORK 



MAXIMUM COST 



MAXIMUM HOPS 



MAXIMUM VISITATION COUNT 



AREA MAXIMUM COST 



AREA MAXIMUM HOPS 



SQUARE ROOT LIMITING FACTOR 



ROUTING TIMER (SECONDS) 



BROADCAST ROUTING TIMER (SECONDS) 



BROADCAST ROUTER PRIORITY 



DSNBRA 

D+NBEA 

D$NN 

D$NA 

DSMAXC 

D$MAXH 

DSMAXV 

DSAMXC 

D$AMXH 

DSSQRL 

D$RTMR 

D$BRTM 

D$BRPR 
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Figure 25 DECnet Home Block (Sheet 2 of 2) 
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ADJDF$ - Adjacency Database Part 1 

The Adjacency Database contains information about each 
adjacent node (point-to-point neighbors and NI neighbors) . Due to 
the size and attendant mapping problems, the database is split 
into two sections (ADJ1 and ADJ2) . Adjacency Database Part 1 can 
be mapped by the bias contained in N$ADJ1 of the XPT database. 
The Adjacency Database is not present for nonrouting (end) nodes. 



ASCIR 



NODE ID OF ADJACENCY 



CHANNEL NO. 



NODE TYPE 



ENTRY NUMBER 2 



ENTRY NUMBER N 



A$NID 
A$TYP 



Figure 26 Adjacency Database Part 1 



A$TYP Node Type Flag Definitions 



7 


6 


5 


4 


3 


2 


1 






















| j ATSLV2- LEVEL 2 ROUTING NODE 

I AT$LV1 - LEVEL 1 ROUTING NODE 

AT$CYC - ADJACENCY BEING RECYCLED 
AT$UP - NODE "UP" ON BROADCAST CHANNEL 
ATSAUP - ADJACENCY COMING UP 
AT$ADN - ADJACENCY GOING DOWN 
ATSACL - ADJACENCY IS TO BE CLEANED UP BY RCP 
ATSHEX - ROUTER TASK SYNCHRONIZATION FLAG FOR ADJACENCY CLEAN UP 



MKV84-0278 



Figure 27 A$TYP Node Type Flag Definitions 
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ADJDF$ - Adjacency Database Part 2 

The Adjacency Database contains information about each 
adjacent node (point-to-point neighbors and NI neighbors) . Due to 
the size and attendant mapping problems, the database is split 
into two sections (ADJ1 and ADJ2) . Adjacency Database Part 2 can 
be mapped by the bias contained in N$ADJ2 of the XPT database. 
The Adjacency Database is not present for nonrouting (end) nodes. 



A$TM 



BLOCK SIZE 



LISTEN TiMER 



INIT. LIS. TIMER 



ENTRY NUMBER 2 



ENTRY NUMBER N 



ASTSZ 
A$TMI 



NOTE: THE LISTEN TIMER AND INITIAL TIMER VALUES 

ARE KEPT AS MULTIPLES OF 4 SECOND INTERVALS. 
THiS ALLOWS FOR A MAXIMUM VALUE OF 
1020 SECONDS (4 255). 

MKV84-0462 

Figure 28 Adjacency Database Part 2 
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LLTDF$ - Logical Link Table Entry 

Each LLT entry contains the current information for a single 
logical link. the LLT is used by the ECL process and the NETACP 
task to service logical links. the LLT entries of a running 
DECnet system can be dumped using the CEDump /LL switch. 



L.TYP 


LINK TYPE 


LINK STATE 


L.STA 




LOCAL LOGICAL LINK ADDRESS 


L.LLA 




REMOTE LOGICAL LINK ADDRESS 


L.RLA 




REMOTE NODE 16 BIT ADDRESS 


L.REM 


L.TIPD 


# DATA XMTS IN PROG. 


# l/LS XMTS IN PROG. 


L.TIPI 


L.VER 


REMOTE NSP VERSION 


LINK FLAGS 


L.FLAG 




NEXT DATA SEGMENT NUMBER TO BE ASSIGNED 


L.NXN 




NEXT l/LS SEGMENT NUMBER TO BE ASSIGNED 


L.NIN 




NEXT DATA SEGMENT NUMBER TO BE RECEIVED 


L.RNO 




HIGHEST ACK # FROM USER ON DATA CHAN 


L.USA 




NEXT l/LS SEGMENT NUMBER TO BE RECEIVED 


LLNO 




HIGHEST l/LS ACK # FROM USER 


L.LSA 




LAST DATA SEGMENT NUMBER ACK'D 


L.LDA 




LAST INT/LS SEGMENT NUMBER ACK'D 


L.LIA 


L.CSTA 


NET DISC SUBSTATE 


USER DISC SUBSTATE 


L.USTA 




POINTER TO USER'S WINDOW BLOCK 


L.WIND 


L.TIC 


INTERRUPT COUNT 


TRANSMIT COUNT 


L.TC 




FLOW CONTROL REQUEST COUNT (l/LS) 


L.LSFI 




FLOW CONTROL REQUEST COUNT (DATA) 


L.LSFD 




REMOTE FLOW CONTROL COUNT ESTIMATE 


L.RCF 




l/LS PENDING ACK QUEUE 


L.ILSQ 


L.RTYD 


RETRY CELL (DATA) 


TIMER CELL (DATA) 


L.TMRD 


L.RTYI 


RETRY CELL (l/LS) 


TIMER CELL (l/LS) 


L.TMRI 




MESSAGE AWAITING RETRANSMISSION 


L.RTQ 




LONG TERM TIMER 


L.LIT 
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Figure 29 Logical Link Table Entry (Sheet 1 of 2) 
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r • • 
L.LPT 



L.MAST 



L.OPD 



PERIODIC TIMER 


TIMER (SECONDS) 


INITIAL LONG TERM TIMER 


MESSAGE REASSEMBLY QUEUE 


REASS. QUEUE TMR. | SIZE OF REASS. QUEUE 


POINTER TO ECL COUNTER BLOCK 


SEGMENT SIZE FOR THIS LINK 


DISCONNECT REASON CODE 


OPTIONAL DATA 


OPTIONAL DATA LEN. 


(16 BYTES) 




(RESERVED) 





LSEC 

L.ILTT 

LMASQ 

LMASZ 

L.CTR 

L.SEGZ 

L.DCR 

L.OPDL 



The following additional fields are only included 
Level Interface (SLI) is present. 



if System 



L.ULA 
L.PDVD 



USER LINK ADDRESS 



DATA PROCESS PDV 



SOURCE CHANNEL* 



CONTROL PROCESS PDV 



TRANSMIT MESSAGE QUEUE DOUBLEWORD 
LISTHEAD 



CURRENT TRANSMIT CCB ADDRESS 



INTERRUPT MESSAGE TRANSMIT QUEUE 
DOUBLEWORD LISTHEAD 



CURRENT INTERRUPT CCB ADDRESS 



PENDING CONTROL CCB ADDRESS 



PENDING ACCEPT CCB ADDRESS 



LCHN 

L.PDVC 

LXMTQ 

LCXMT 
L.INTQ 

L.CINT 
L.PCTL 
L.ACC 

MKV84-0456 



Figure 29 Logical Link Table Entry (Sheet 2 of 2) 
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PLBDF$ - Physical Link Block (PLB) <DSR> 

The Physical Link Block is used by XPT to maintain the current 
status and control/monitor each physical connection to an adjacent 
node. Pointers to each PLB entry reside in the Physical Link 
Block Vector Table. 



P$TYP 


ADJ. NODE TYPE 


LINK STATE 


P$LST 


P$RTIM 


RECOVERY TIMER 


RECOVERY FLAGS 


P$LCD 


P$CNT 


#MESG'S QUEUED 


XPT CHANNEL* 


P$CHN 




PENDING CONTROL FUNCTION QUEUE 


P$PFQ 




GENERAL PROTOCOL TIMER 


P$TIM 




FLAGS 


P$FLG 




(RESERVED) 


INP. PACKET LIN 


P$IPL 




MAX DELAY FOR ROUT. MSG. LEVEL 1 


P$RMX1 




MAX DELAY FOR ROUT. MSG. LEVEL 2 


P$RMX2 




LEVEL 2 STATE 


LEVEL 1 STATE 


PSSTA 1 




TRANSPORT BLOCK SIZE 


P$TSIZ 




COUNT OF ADJ. NODES OF LOW TSIZ 


P$TSCT 




STORE AND FORWARD QUEUE 
DOUBLEWORD LISTHEAD 


P$FWD 




TRANSPORT COUNTER BLOCK ADDRESS 


P$CTR 




16-BIT ADDRESS OF DES. ROUTER 


P$DRTR 




NUMBER OF ROUTERS ON Nl 


P$NRNI 




CIRCUIT ROUTING PRIORITY 


PSRPRI 



The following cells are only used for DLM circuits 



DATA LINK MAPPING PACKET SIZE 


PSPKSZ 


INPUT REASSEMBLY CCB 


P$ICCB 


OUTPUT SEGMENTATION QUEUE 


PSOCCB 


HOLDING AREA FOR INIT. SEED 
(4 WORDS) 


PSSEED 
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Figure 30 Physical Link Block (Sheet 1 of 2) 
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XPDDB$ - XPT Database 

The data shared between the XPT process and the Routing tasks 

(RCP1/RCP2) is contained in this structure. The pointer to the 

data is contained in the Process Descriptor LLC database address 
cell (Z.DAT) for the XPT process. 



NSRTM2 



TCB ADDRESS OF LEVEL 1 ROUTER 



LEVEL 1 ROUTING MESSAGE 
DOUBLEWORD LISTHEAD 



TCB ADDRESS OF LEVEL 2 ROUTER 



LEVEL 2 ROUTING MESSAGE 
DOUBLEWORD LISTHEAD 



LEVEL 2 RT. TIMER 



LEVEL 1 RT. TIMER 



PHYSICAL LINK BLOCK VECTOR SIZE 
PHYSICAL LINK BLOCK VECTOR ADDRESS 



REACHABILITY VECTOR SIZE 
REACHABILITY VECTOR BIAS 
REACHABILITY VECTOR ADDRESS 



AREA REACHABILITY VECTOR SIZE 
AREA REACHABILITY VECTOR BIAS 
AREA REACHABILITY VECTOR ADDRESS 



MINHOP/MINCOST VECTOR SIZE 
MINHOP/MINCOST VECTOR BIAS 
MINHOP/MINCOST VECTOR ADDRESS 



AREA MINHOP/MINCOST VECTOR SIZE 
AREA MINHOP/MINCOST VECTOR BIAS 
AREA MINHOP/MINCOST VECTOR ADDRESS 



Nl CACHE SIZE 

Nl CACHE ADDRESS 



NUMBER OF PASSWORD DATABASE ENTRIES 
PASSWORD DATABASE ADDRESS 



N$RT1 
N$LV1 

N$RT2 
N$LV2 

NSRTM1 
N$PLD 

NSROA1 

NSROA2 

NSMHC1 

NSMCH2 

N$CACH 
NSVER 
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Figure 31 XPT Database (Sheet 1 of 2) 
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BIAS OF ADJACENCY DATABASE PART 1 



BIAS OF ADJACENCY DATABASE PART 2 



BROADCAST ROUTER PRIORITY TABLE ADDR. 



NUMBER OF TRANSPORT LINE CNTR BLOCKS 
TRANSPORT LINE COUNTER BIAS 
TRANSPORT LINE COUNTERS ADDRESS 



TRACE CONTROL WORD 



TRACE COLLECTOR TCB ADDRESS 



TRACE CONTROL BLOCK ADDRESS 



TRANSPORT NODE COUNTER SIZE 
TRANSPORT NODE COUNTERS ADDRESS 



N$ADJ1 
N$ADJ2 
N$PRI 
N$TLC 



N$TRC 
N$TTCB 
N$TCTL 
N$TNC 



THE FOLLOWING ADDITIONAL CELL IS PRESENT ONLY ON DLM NODES: 

N$CRC 



STCRC LIBRARY POINTER 



MKV84-0457 



Figure 31 XPT Database {Sheet 2 of 2) 
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ECDDBS - ECL Database <DSR> 

The data shared between the ECL process and the NETACP task is 
contained in this structure. The pointer to the data is contained 
in the Process Descriptor LLC database address cell (Z.DAT) for 
the ECL process. 





NETWORK ACP CCB QUEUE 
DOUBLEWORD LISTHEAD 


N$FLG 


FLAGS BYTE 


TIMER COUNT 




FUNCTION CODE 




DUMMY VCB 




SOURCE NODE ADDRESS 




(RESERVED) 


ROUND TRIP DELAY 




SOURCE LINK ADDRESS 




DESTINATION LINK ADDRESS 




ERROR CODE 




MAPPING OF CURRENT LLT 




CURRENT LLT VIRTUAL ADDRESS 




CURRENT LLT PHYSICAL ADDRESS 


NSniGri 


MAX ACT LOG LiNKS | CUR ACT LOG LINKS 




COUNT OF CI'S IGNORED DUE TO RESOURCES 




LOGICAL LINK TABLE LENGTH 
LOGICAL LINK TABLE ADDRESS 




ECL NODE COUNTERS 

DOUBLEWORD LISTHEAD 

ECL MODE COUNTERS APR BIAS 




MAILBOX QUEUE LISTHEAD 




GENERAL DELIVERY CCB QUEUE LISTHEAD 


NSGTI 


GEN DEL INI TIMER 


GEN DEL CUR TIMER 



NSACQ 

N$TIM 

N$FNC 

N$VCB 

NSSNOD 

NSDLY 

NSSLA 

N$DLA 

N$ERRC 

NSLLTM 

N$LLT 

N$PLLT 

NSACTL 

N$CIR 

N$VLC 

N$ENC 



NSMBXQ 
N$GENQ 
N$GTM 
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Figure 32 ECL Databases 
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CACDF$ - Nl Cache <DSR> 



The 
nodes, 
certain 
is set 
without 
Cache is 



NI Cache is only present for nonrouting (end) Ethernet 
It contains information about the next hop to get to 

nodes. Entries are made in the cache when a logical link 
up to a node and removed when a time interval has elapsed 

any communications with that node. The pointer to the NI 
contained in the XPT database. 



NODE ID OF DESTINATION 



NODE ID OF NEXT HOP 



LIFETIME TIMER 



NEXT ENTRY 



CSNID 
C$NXH 



C$TIM 



NOTE: THE NODE ID OF DESTINATION (CSNID) IS A 16 BIT NODE 
ADDRESS AND THE NODE ID OF NEXT HOP (C$NXH) IS A 48 BIT 
NODE ADDRESS. 



MKV84-0279 



Figure 33 NI Cache 
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Free Communication Control Block (CCB) List <DSR> 





UNIBUS RUN MASK (M+ ONLY) 


C.UPM 




LiNKTONEXTCCE 


P 1 Ml/' .„, . 




U.LINN 

C.RSV 

C.NSP 

C.LIN 

C.FNC 

C.STS 

C.BUF1 

C.CNT1 
C.FLG1 
C.BUF2 

C.CNT2 
C.FLG2 


C.BID 


BUFFER ID | RESERVED 




NSP RESERVED CALL 


C.ST A 


STATION # 


LINE# 


C.MOD 


FUNC CODE MOD 


FUNCTION CODE 




STATUS WORD 




FIRST BUFFER ADDRESS 
DOUBLEWORD 




FIRST BUFFER COUNT 




FIRST BUFFER FLAGS 




SECOND BUFFER ADDRESS 
DOUBLEWORD 




SECOND BUFFER COUNT 




SECOND BUFFER FLAGS 




LLC SPECIFIC 
(4 WORDS) 








LINK TO NEXT CCB (LAST=0) 








BODY OF CCB 

• • • 





MKV84-0467 



Figure 34 Free Communication Control Block List 
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LLC Specific Data for Ethernet 



48-BIT ETHERNET ADDRESS 



ETHERNET PROTOCOL TYPE 



C.ADD 



C.PRO 



MKV84J1578 



Figure 35 LLC Specific Data for Ethernet 



LLC Specific Data for PSI 



C.XID 


CALLING DTE 


LVL. 3 PORT NO. 


C.XPT 


C.XTC 


PACKET TYPE 


PLI USER BYTE 


C.X25 




SCRATCH WORD FOR PLI/LLCS 


C.XPLI 




(RESERVED) 
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Figure 36 LLC Specific Data for PSI 
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Process Descriptor Vector (PDV) Table <CES Pool> 



SPDVTB 



$PDVNM 



Z.SCH 



Z.SCH 











LLC PVD ADDRESS 










DLCPVD ADDRESS 










DDM PVD ADDRESS 


Z.DSP-»— 








PROCESS RELOCATION BIAS 


DISPATCH TABLE VIRTUAL ADDRESS 


Z.NAM 

Z.LLN 

Z.FLG 

Z.PCB 

Z.AVL 

Z.DAT 

Z.MAP 


PROCESS NAME (RAD50) 


PRIORITY | .# CHANNELS 


FLAG WORD 


PCB ADDRESS IF LOADED 


PTR TO 1ST FREE BLOCK-PROCESS 


LLC DATABASE VIRTUAL ADDRESS 


CHANNEL CIRCUIT ID 


CHANNEL N CIRCUIT ID 




PROCESS RELOCATION BIAS 


t.Uol ■* 


DISPATCH TABLE VIRTUAL ADDRESS 




PROCESS NAME (RAD50) 


Z.NAM 


PRIORITY 


UNUSED 


Z.LLN 


FLAG WORD 


Z.FLG 


PCB ADDRESS IF LOADED 


Z.PCB 


PROCESS FREE SPACE POINTER 


Z.AVL 






MKV84-0453 



Figure 37 Process Descriptor Vector Table 
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MBXDF$ - Mailbox Queue <CfiS Pool> 



t 



A 



A mailbox is created when a user task indicates that it is an 
active network user by issuing an OPN$ function. The mailbox 
holds common information about the user task for use by the 
network software. 





(RESERVED FOR RSX) 




LINK TO NEXT MAILBOX 




POINTER TO TASK TCB 


M.NAST 


#OFASTENT 


(RESERVED) 


M.MAX 


MAX # OF LLS 


#OF ACT LLS 




USER NETWORK DATA AST ADDRESS 




NETWORK DATA LIST-HEAD 




LINK RECOVERY TIMER 



LINK TO NEXT MAILBOX 



BODY OF THE MAILBOX 



LAST MAILBOX IN LIST (0) 



BODY OF THE MAILBOX 



M.NEXT 
M.TASK 

M.USE 
M.SPA 
M.MAIL 
M.RESP 



MKV84-0281 



Figure 38 Mailbox Queue 
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System Line Table (SLT) Vector - Indexed by SLM <CEX Pool> 



<:qi tmr 


AflHRPCQ OP QI T n 


















ADDRESS OF SLT 1 






L.FLG**— ' 






ETC. 








FLAGS WORD 


LDLC 


DLC PVD INDEX | DDM PDV INDEX 


L.DDM 

LDDS 

L.DLM 

LDLS 

L.CTL 

LNSTA 

L.KRBA 

L.NMST 

S.FLG 

S.NMST 




DDM LINE TABLE ADDRESS 




DLC LINE TABLE BIAS 




DLC LINE TABLE VIRTUAL ADDRESS 


LUNT 


MPXUNIT# 


CONTROLLER # 


L.COST 


LINE COST 


# STATIONS 




CONTROLLER REQUEST BLOCK ADDR 


LOWNR 


LINE OWNER 


MNGMT STATE 


S.COST 


TR IB. COST 


TRIB. FLAGS 


S.OWNR 


TRIB. OWNER 


MNGMT STATE 




ETC. 


ETC. 




SLT 1 ENTRY 








ETC. 





MULTIPOINT AND 
BROADCAST 
CHANNELS ONLY 
{L.MPF OFFSET 
STARTS TRIB 
TABLE) 



MKV84-0282 



Figure 39 System Line Table Vector - Indexed by SLN 



67 



DECnet-RSX INTERNALS 



LLWDF$ - Window Block <CEX Pool> 



The window block holds the current state of a 
with respect to the QIOs issued by the user task, 
to by the second LUN word in the task header. 



logical link 
It is pointed 



W.LUN 



(RESERVED FOR RSX) 


W.CTL 


TASK LUN 


LINK STATUS 


W.STAT 


POINTER TO ASSOCIATED LLT 


W.LLT 


SEGMENT SIZE 


W.SEGZ 


TEMPORARY WORKSPACE 


W.TMP 


POINTER TO MAILBOX 


W.MBOX 


(RESERVED) 


KN1 AST STATUS 


W.KAST 


TRANSMIT QUEUE LISTHEAD 


W.SNDC 


POINTER TO CURRENT XMT I/O PKT 


W.CSND 


POINTER TO CURRENT INT I/O PKT 


W.CINT 


RECEIVE QUEUE LISTHEAD 


W.RCVC 



Figure 40 Window Block 



MKV84-0283 
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PSI Data Structure Summary 



Table 1 Important PSI Data Structures 



Name 


Size 
(Byte«) 


Allocated 
Promt 




Usage 


Related PSI 
Component 


Library 
Macro 


CCB - 

Communication 
Control Block 


28. (3«. for 
multiprocessing) 
+6. for PSI 


CEX remain 
space and 


ting 
DSR 


Interprocess 
communication 


CEX 

NT. XXX 
X25ACP 


PSI. MLB: 
CCBDFS 


PDV - 
Process 
Descriptor 
Vector 


14. +2 for PLIDB 
2. per channel 


CETAB - CEX 

remaining 

space 


Communication 

process 

description 


XXX 


PS I. MLB: 
PDVDFS 


SLT - 
System 
Line 
Table 


18.-f4 per 
tributary 


CETAB - CEX 

remaining 

space 


Interprocess 
interface 
for the 
communication 
channel (PLI) 


XXX 


PSI. MLB: 
SLTDFS 


DTEDB - 
Local DTE 
Descriptor 
Block 


72. 


POOL.. 




Describes local 
DTE's static 
and dynamic 
parameters 


PLI 


PSI. MLB: 
DTEDF$ 


EVL - PLI 
Event Block 


28.+ additional 
data 


DSR 




Formats event 
for EVC 


EVC 


PSI. MLB: 
EVLDF$ 


DDM - Line 

Tauie 


Variable 


XXX 

process 
space* 




Communication 
device-specific 
data, interrupt 
lineage code, 
etc. 


XXX 


PSI. MLB: 
DLMDFS, 
KMXDFS, 
LABDFS, 


DST - 

X.25/X.29 

Destination 

Descriptor 

Block 


24. 


POOL.. 




Describes X.25 
and X.29 
destinations 


NW, 

PLI 


PSI. MLB: 
DSTDFS 



*Note that XXX refers to network processes. 
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Table 1 Important PSI Data Structures (Cont) 



Name 



Size 
(»yte«) 



Allocated 
From: 



Usage 



Related PSI 
Component 



Library 
Macro 



Task 's 
Mailbox 



NUB - 

Network 

Virtual 

Terminal 

Control 

Block 

NWDB - 
NW.LLC 
Database 



Object 

Descriptor 

Block 

PHB - PSI 
Home Block 



PLIDB - PLI 
LLC Database 



20. 



DSR 



26. 



HTDRV 



22. 



DSR 



10. 



34. 



22. 



POOL.. 



DSR 



DSR 



Controls the 


PLI 


PS I. MLB 


task's overall 




MBDFS 


network access; 






has listhead to 






network mail 






(CCBs) and AST 






routine address 






Controls PAD 


X29ACP, 


PS I. MLB 


access 


HT: 


NVBDFS 



Contains pointers 


NW, 


PSI. MLB 


to various 


PLI 


NWDF$ 


important 






NW:-related data 






structures, 






window blocks, 






etc. 






Describes a 


PLI 


PSI. MLB 


Network 




OBJDFS 


Object 






PSI database-, 


PLI 


PSI. MLB 


contains 


and others 


PHBDF$ 


pointers to 






various data 






structures 







Contains pointers 
to various 
important 
PLI-related data 
Structures 



PLI 



PSI. MLB: 
PLIDFS 
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Table 1 Important PSI Data Structures (Cont) 



Name 


Size 
(Bytes) 


PVC - Name 
Block 


14. 


Remote DTE 
Descriptor 
Block 


20. 


Trace Block 


12. 


VCB - Volume 
Control Block 
for NW: 


30. 


Window Block 


34. 



X.25 Circuit 70. 
Block 



X.29 Database 14. 



Allocated 
Proa: 


U., 9 , 


Related PSI 
Component 


Library 
Macro 


POOL. . 


Describes 
a PVC 


WW, 
or t 


PSI. MLB: 


POOL.. 


Describes a 
remote DTE 


NW, 
PLI 


PSI. MLB: 
RDTDFS 


DSR 


Control block 
for trace 
facility 


PLI 
TRADF 


PSI. MLB: 


DSR 


Listhead for 
general delivery 
queue and 
mailboxes 




PSI. MLB: 
VCBDFS 


POOL.. 


Allocated per 
VC and contains 
current infor- 
mation on that 
circuit from 
the user task 


NW, 

PLI 


PSI. MLB: 
WBDF$ 


POOL.. 


Circuit manage- 
ment-related 
information 
used by PLI 


PLI 


PSI. MLB: 
XCBDF$ 


DSR 


X29 counter 
block 


X29ACP 


PS I. MLB: 
X29DFS 



71 



DECnet-RSX INTERNALS 



PSI Data Structure Offsets 



PSI Home Block 

PSI structure: PHB 

Size (bytes) : 34. 

Total number: One 

Allocated from: DSR 

Allocated when: On loading the network by NTL 

Pointed to by: $PSIPT: : in CEXCM 

Macro in PS I. MLB: PHBDF$ 



GENERAL FLAGS 


00 
02 
04 
06 
10 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 
36 
40 


. H$FLG 


LOCAL DTE DESCRIPTOR LIST 


H$LDTE 


REMOTE DTE DESCRIPTOR LIST 


H$RDTE 


PVC NAME LIST 


H$PVC 


CUG NAME LIST 


H$CUG 


X.25 DESTINATION BLOCK LIST 


H$DST 


X.29 DESTINATION BLOCK LIST 


H$D29 


TRACE BLOCK 


H$TRB 


PORT TABLE POINTER 


H$PTB 


NUMBER OF PORTS 


H$NPT 


NETWORK NAME (ASCII) 


H$NETW 


LOW TRANSPORT SUBADDRESS 


H$LOTS 


HIGH TRANSPORT SUBADDRESS 


H$HITS 


SVC BLOCKS (FOR DLM) 


H$SVC 


POINTER TO X.29 DATABLOCK 


H$X29C 



Figure 41 PSI Home Block (PHB) 
Offset Definition 
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NW:LLC Database 

PSI structure: NWDB 

Size (bytes) : 22. 

Total number: One 

Allocated from: DSR 

Allocated when: By NTL on loading the network 

Pointed to by: Z.DAT in PDV for NW: 

Macro in PS I. MLB: NWDF$ 



ZSLLRE 



POINTER TO WINDOW BLOCK ADDRESS TABLE 



POINTER TO END OF WB TABLE 



QUEUE LISTHEAD OF CCBS FOR X25ACP 



POINTER TO UCB FOR NW: 



COUNTER TIMER PERIOD 



COUNT OF CURRENTLY ACTIVE CIRCUITS 



TIME WHEN COUNTERS LAST ZEROED 



MAX CIRCUITS ACTIVE 



UNUSED 



INCOMING CALLS RESOURCE ERRORS 



00 ZSWBAT 



04 


ZSWEND 


06 


ZSACPQ 


10 




12 


Z$UCB 


14 


ZSCTIM 


16 


Z$ACTC 


20 


Z$TCLZ 


22 


Z$MXAC 


24 


Z$ICRE 



Figure 42 NW: LLC Database Offset Definition 
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PLI Data Descriptor Block (PLI LLC Database) 

PSI structure: PLIDB 

Size (bytes): 22. 

Total number: One 

Allocated from: DSR 

Allocated when: On loading the network by NTL 

Pointed to by: Z.DAT in PDV for PLI 

Macro in PSI.MLB: PLIDF$ 





FLAG WORD 


00 
02 
04 
06 
10 
12 
14 
16 
20 
22 
24 


Y$FLG 




DEFAULT PACKET SIZE 


YSDPSZ 




MAXIMUM PACKET SIZE 


Y$MPSZ 


Y$MWSZ 


MAX WINDOW SIZE 


DEFAULT WINDOW SIZE 


Y$DWSZ 


YSTCAL 


CALL REQUEST TIMER 


RESTART TIMER 


Y$TRST 


Y$TCLR 


CLEAR TIMER 


RESET TIMER 


Y$TRES 


Y$MRES 


MAX RESET RETRIES 


MAX RESTART RETRIES 


Y$MRST 


Y$LMPK 


LOG2 MAX PACKET SIZE 


MAX CLEAR RETRIES 


YSMCLR 




DTE ADDRESS LENGTH 


YSDTAL 




DTE SUBADDRESS LENGTH 


Y$DSAL 



TK-8469 



Figure 43 PLI LLC Database Offset Definition 
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Window Block for X.25 

PSI structure: W 

Size (bytes) : 34. 

Total number: One per active circuit 

Allocated from: POOL.. 

Allocated when: CAL$ or CAC$ calls 

Pointed to by: .WBATB:: listhead in ACPROO module of X25ACP; 

Z$WBAT in NW:LLC database 
Macro in PS I. MLB: WBDF$ 





FLAG WORD 


W$LUN 


LUN# FOR CIRCUIT 


CIRCUIT TYPE 




SPARE 


CIRCUIT PORT # 




PACKET SIZE 




MAILBOX. ADDRESS 




PENDING XMTS I/O PACKETS LISTHEAD 




PENDING RCV$ I/O PACKETS LISTHEAD 




LDBS PENDING TRANSMISSION PACKET LISTHEAD 




RDBS PENDING RECEPTION PACKET LISTHEAD 




IN-PROGRESS I/O PACKETS LISTHEAD 
(FOR X25ACP) 


WSDAST 


OUTSTANDING ASTS 


CCB IN USE FOR XMT$ 


W$FLUX 


HIGH BYTE OF FLAGS (XMT$) 


SPARE 



00 


W$FLAG 


02 


W$TYP 


04 


W$PORT 


06 


W$PKSZ 


10 


W$MBOX 


12 


W$SNDQ 


14 




16 


W$RCVQ 


20 




22 


W$TXCQ 


24 




26 


W$RXCQ 


30 




32 


W$PIO 


34 




36 


W$CCBU 


40 






TK-8470 



Figure 44 Window Block for X.25 Offset Definition 
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PSI structure: XCB 

Size (bytes) : 70. 

Total number: One per active circuit 

Allocated from: POOL.. 

Allocated when: CAL$ or CAC$, preallocated for 

Pointed to by: Port table entry (through H$PTB 

block) 
Macro in PS I. MLB: XCBDF$ 



PVCs 

in PSI home 



XSTIMC 


CALL/CLEAR TIMER 


RESET TIMER 


00 

02 

04 

06 

10 

12 

14 

16 

20 

22 

24 

26 

30 

32 

34 

36 

40 

42 

44 

46 

50 

52 

54 

56 

60 

62 

64 

66 

70 

72 

74 

76 

100 

102 

104 


XSTIMR 


XSDIAG 


LAST DIAGNOSTIC USED 


RETRY COUNT 


XSRTRY 


XSST 


CIRCUIT STATE 


CIRCUIT SUBST ATE 


X$SS 


X$NPR 


# TO ABORT IMMEDIATELY 


# OF PACKETS IN LOWER LEVEL 


XSNPL 


X$PR 


P(R) FOR NEXT TX 


P(S) FOR NEXT TX 


XSPS 


XSRPR 


LAST RECEIVED P(R) 


NEXT EXPECTED RX P(S) 


XSRPS 


X$TYP 


TYPE BYTE 


FLAG BYTE 


XSFLG 




PACKET SIZE (TX) 


XSPKSZ 


XSPRT 


PORT NUMBER 


WINDOW SIZE 


XSWSZ 


XSMOWN 


OWNER 


HIGHER LEVEL PDV/SLN 


XSUSR 




POINTER TO LOCAL DTE 


XSDTE 




LOGICAL CHANNEL NUMBER 


XSLCN 




TIME COUNTERS LAST ZEROED 


XSTCLZ 




BYTES RECEIVED 


XSNRBY 




BYTES TRANSMITTED 


XSNTBY 




DATA PACKETS RECEIVED 


XSNRPK 




DATA PACKETS TRANSMITTED 


XSNTPK 


XSNRRE 


REMOTE RESETS 


LOCAL RESETS 


XSNLRE 


XSALF 


ALLOCATION FAILURE FLAGS 


NETWORK GENERATED RESETS 


XSNNRE 




AUTOMATIC TIMER COUNTDOWN 


XSAUC 




TIMER COUNTER VALUE 


XSCTIM 




WAITING ACKNOWLEDGEMENT 


XSWAQ 




AWAITING TRANSMISSION 


XSTXQ 




RECEIVER HOLD QUEUE 


XSRXQ 




LIST OF CCBS TO ABORT 


XSABQ 




TRANSMIT INTERRUPT 


XSTXI 




RECEIVE INTERRUPT 


XSRX! 



Figure 45 X.25 Circuit Block Offset Definition 
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APPENDIX C 
DECnet-RSX Listing Trace 



Listing Trace Technique 

• The technique of multiple passes is recommended. 

• Preparation work: 

- Have an idea of the major components and their 
interaction. 

- Have copies of the map and listings available either on 
paper or on microfiche. 

Learn how to use the map and listings effectively, in 
particular: 

1. Be able to identify the starting address of the 
major component, if any. 

2. Be able to find out how many modules make up a 
major component. 

3. If given a global symbol, be able to identify which 
module and which line of code defines the global 
symbol. 

• Pass 1 

Treat t he listing like a road map. Make sure you don't 
*g^t lost • """' "■""""'-"' ---— — — ~ 

" ^nlyfocus on instructions^ that pass control to another 
modu le or s13bToruTine*T Do" "ho t~ try to follow every 
Thstruction in the first pass. 

If you have paper listings, use a highlight pen to 
trace the major paths. If you use microfiche, chart 
^out~~a~ simpTe~major path. 
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• Pass 2 

- Assume an error free path. Use the map or highlighted 
listings to extract interesting information. 

- Under DECnet, the interesting paths may be to trace 
through: 

1. Issuing network open 

2. Sending connect initiate 

3. Sending connect confirm 

4. Sending/receiving normal data 

5. Sending/receiving interrupt data 

6. Disconnecting logical link 

7. Specifying network AST 

8. Getting network data 

9. Disconnecting logical link 
10. Issuing network close 

• Pass 3 

- Relate the data structure to the code. 

Put in sufficient comments to get a simple tour guide 
through the listings. 

• Subsequent passes are to obtain specified information. 

t An example of this technique is shown on tracing sending 
and receiving of a connect initiate message. 
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Sending of Connect Initiate Message 

Table 2 tracing ^» onnec ^ j n ^^^ a ^ e 

Path Ref Co mil en ts 

1 RSX Internals The Connect Initiate request is translated 
Course to a QIO or QIOW request. 

(a) The Directive Parameter Block (DPB) is 
set up and control is passed to the 
RSX-11M executive by using the EMT377 
instruction. 

(b) The EMT trap vector (in module LOWCR) 
passes control to the Directive 
Dispatcher Module (DRDSP) . 

(c) General purpose registers are saved by 
using a coroutine call to the system 
entrance and exit module (SYSXT) and 
control is passed back to DRDSP. 

(d) The parameters in the DPB are checked 
and the correct directive handling 
module is called. In this case, the 
directive handling module is DRQIO. 

(e) The I/O request packet is built and 
the RSX executive assists the device 
driver by looking at the function 
masks of the driver. For functions 
to be handled by the device driver, 
the RSX executive calls the driver 
at the initialization routine. 

(f) For connect requests, the NS driver is 
used. The I/O request is passed to it 
at NSCHK in the ECL communication 
process. 

2 ECLQIO (a) Check whether OPN$ has been issued. 

If so, check the buffers containing 
the connect request block. 

(b) Allocate space and set up certain 
fields for the window block. 

(c) Call NETACP. 
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Table 2 Tracing Connect Initiate (Cont) 



Path Ref 



Comments 



SESDSP 



S ESC ON 



SESUSR 



(a) The NETACP is characterized by its 
dispatch or stop main loop. When 
there is nothing to do r the NETACP 
sets its own stop bit. When acti- 
vated by the executive (unsettlng 
its Stop bit), it looks for work in 
one of the two queues - a Communi- 
cation Control Block (CCB) queue 
and the I/O request packet queue. 

(b) If there is something in these 
queues, the NETACP dispatches to 
one of its processing modules and 
keeps on looping until all entries 
are processed. 

For the Connect Initiate request,- an 
internal connect block is set up to prepare 
for sending of the Connect Initiate message. 

(a) The node name is converted to node 
address. 



(b) Data structures related to logical 
link are created. 



ECLSUB 
ECLXMT 



XPTRCV 
XPTXMT 



(c) The session control portion of the 

message is built, and control is passed 
back to ECL by using CEX. 

(a) The data subchannel is used to transmit 
the connect initiate message. 

(b) The routing module (XPT) is called by 
using CEX. 

(a) The process dispatch table in XPTRCV is 
entered. The entry in this table is 
transmit enabled. 



(b) The appropriate headers are built and 
control is passed to the device driver 
module by using CEX - another mapped 
subroutine call. 
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Table 2 Tracing Connect Initiate (Cont) 
Path Re f Consents 

9 (a) The connect initiate message is sent 

10 out* 

(b) The data link header is built by the 
DMC hardware. 

11 (a) The connect initiate message is 

12 received by the data link driver 

and passed to the XPT process by 
using fork processing. 

(b) The routing module determines 
whether the packet is for the 
local node. If so, it passes 
it to. the ECL process also by 
using the fork processing. 

13 ECLRCV The process dispatch table in ECL is 

entered and because it is a control 
function, NETACP is called. The CCB 
queue is used to pass information to 
NETACP. 

14 SESDSP (a) The CI message is checked and the 

15 logical link address table is 

checked to see If another one can 
be created. 

(b) Tell user about received CI and 

send the Connect Acknowledge back. 
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Connect Initiate (Part 1) 



I ECLXMTl 




USER TASK 



MKV84.0580 



Figure 46 Sending Connect Initiate 
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Connect Initiate (Part 2) 



mwi i nitiiii ■> I ml 



CEX 



RSX11M EXEC 




13 



ECLSUB 



SESDSP 



15 



SESPRO 



USER TASK 




MKV84-0581 



Figure 47 Receiving Connect Initiate 
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EXERCISES 

Select the best answers for each of the following statements 

1. Under RSX-11, DECnet is implemented as as 

a. Privileged task 

b. Core-resident process 

c. Layered product 

d. b and c only 

2. The NETACP task is used to support: 

a. The N: driver 

b. The NS: driver 

c. The NW: driver 

de The NS: and N: drivers 

3. The Network Data Queue is allocated when the: 

a. Connect Initiate is issued 

b. Open the Network call is executed 

c. Connect Accept is issued 

d. None of the above 

4. The user task retrieves data messages: 

a. From the Network Data Queue 

b. Directly from the NS: driver 

c. From the NETACP task 

d. b and c only 
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5. Communications Control Blocks are allocated from: 

a. Dynamic Storage Region 

b. Network Buffer Pool 

c. The GEN partition 

d. The remaining space in CEXPAR 

6. All DECnet tasks on RSX-11 are usually mapped by: 

a. Kernel APR3 

b. Kernel APR5 

c. RSX-11 Executive 

d. Program Counter 

7. All incoming messages are initially dispatched by: 

a. The RSX-11 Fork Queue dispatcher 

b. The Fork processing routine in the AUX process 

c. The DDM process to the CEX 

d. None of the above 
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SOLUTIONS 

Select the best answers for each of the following statements 

1. Under RSX-11, DECnet is implemented as a: 

a. Privileged task 

b. Core-resident process 
Q Layered product 

d. b and c only 

2. The NETACP task is used to support: 
a« The N: driver . 

(b^) The NS: driver 

c. The NW: driver 

d. The NS: and N: drivers 

3= The Network Data Queue is allocated when the: 
a. Connect Initiate is issued 
(bJ Open the Network call is executed 

c. Connect Accept is issued 

d. None of the above 

4. The user task retrieves data messages: 
a. From the Network Data Queue 
(bj Directly from the NS: driver 

c. From the NETACP task 

d. b and c only 
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5. Communications Control Blocks are allocated from: 
-/a"^) Dynamic Storage Region 

b. Network Buffer Pool 

c. The GEN partition 

(cH) The remaining space in CEXPAR 

6. All DECnet tasks on RSX-11 are usually mapped by: 
a. Kernel APR3 

(b) Kernel APR5 

c. RSX-11 Executive 

d. Program Counter 

7. All incoming messages are initially dispatched by: 
a. The RSX-11 Fork Queue dispatcher 

The Fork processing routine in the AUX process 

c. The DDM process to the CEX 

d. None of the above 
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DECnet-RSX NODE TROUBLESHOOTING 



INTRODUCTION 

Simple node troubleshooting techniques are available for 
dealing with network problems on a node. 

The problems with the network node may be grouped into the 
following categories: 

• Memory-related — Not enough physical memory to load the 
network components, not enough DSR space to run the RSX-11 
with the DECnet-RSX software. 

• Network configuration-related — Communication hardware is 
not installed properly or not operational, or a 
communication line is noisy. 

• Network management-related — Two or more nodes in the 
network have the same node numbers; verification for the 
network objects is not set properly; running out of 
LDB/RDBs or logical links. 

• Node load-related — The RSX-11 local activity during peak 
periods slows down the DECnet-RSX operations and introduces 
undesirable effects in the network. 

A set of tools is available for detecting and fixing simple 
network node problems. When a problem is more complicated (for 
example, a network software problem), more sophisticated tools may 
be used such as a CRT data analyzer, network trace programs, 
crash/network dump analysis. Source listings may be used for 
retrieving specific information that is not documented by the 
standard reference materials. 

This module presents some common tools available for 
troubleshooting the DECnet-RSX node. Standard network management 
techniques (loopback tests, evaluating error counters, DTS/DTR 
tests, NTD displays) are presented in the Network Management 
module, and therefore are not discussed here. The topics covered 
in this module are: 

• Problems with insufficient memory 

• Insufficient number of network components 

• Tuning and modifying the global symbols 

• Crash dump and related problems 
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OBJECTIVES 

Upon completion of this module, the specialist should be able 



to; 



• Recognize and understand typical network problems on the 
DECnet-RSX node. 

• Troubleshoot a given node problem using available software 
tools. 



RESOURCES 

1. DECnet-RSX Network Generation and Installation Guide 

2. DECnet-RSX Release Notes 

3. DECnet-RSX Overview 
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LOADING THE NETWORK 

One way of loading the network is to use the NCP command: 
>NCP SET SYSTEM 

This command initiates a series of actions. The executive 
first loads NCP in GEN. NCP then makes an I/O request to the 
Network Management Driver (NMDRV). The driver calls the Network 
Management Volatile ACP (NMVACP). NMVACP in turn calls the 
Network Initialization Task (NTINIT). After performing 
initialization, NTINIT calls the Network Loader (NTL) , to actually 
load the network. Thus the entire sequence is as follows: 

NCP — ^ NMDRV — ^ NMVACP « ^ NTINIT ■ ^> NTL J> NetWOrk HYOiO 

In performing this sequence, each task is loaded into GEN in 
turn. Each task can checkpoint the task that precedes it in the 
calling sequence, if it needs memory to run. However, because NCP 
has an I/O request outstanding, it cannot be checkpointed by other 
tasks; it remains in memory until the entire cycle is completed. 
Likewise, when NTL loads the network, it cannot checkpoint other 
tasks to make room for the network processes. This is due to 
certain technical features of NTL. 

Generally, the loading procedure described proceeds 
satisfactorily. However, consider the following case. Suppose 
the loading procedure occurs and NCP, NMDRV, NMVACP, NTINIT, and 
NTL are all in memory at the same time. No checkpointing occurs 
because there is enough memory for all; there is even 10K of 
memory left over. NTL then tries to load the network. The load 
fails because the network, takes a minimum of- 16K to load and there 
is only 10K available. NTL tries to load in the existing space, 
but since it is incapable of checkpointing other tasks, it fails 
and prints an error message. 

This problem can only occur when you attempt to load the 
network and, depending upon the size of your system, can be 
prevented in a variety of ways. These include removing extraneous 
application tasks and loading the network when booting the system, 
thus ensuring that the maximum amount of memory is available. 
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INSUFFICIENT MEMORY 



>9LB:C300*13NETIN3 

>* Do «ou want to install and load the CEX system? CY/N3: Y 

>* Do you want to install and start DECnet? CY/N3: Y 

>* On what device are the network tasks CD=DL0:3 CSK 

MNS XX:C300.541NTINIT 

MNS XX:C300»543NTL 

MNS XX:C300»54 3EVC 

..INS XX:C300r543NCP 

>i INS XX:C300»54 3CFE 

MNS XX:C300»54:NMVACP 

>SET /SYSUIC=l300»543 

>asn xx:=lb: 
>loa nh;/high 
>asn =lb: 

; SET /SYSUIC=C1f543 

MNS XX:C300»543NETACP 

MNS XX:C300»54DNICE 

>INS XX:C300»543EVR 

>INS XX:C300f54DNTD 

>INS XXtC3O0»54JNTBEH0 

>INS XXJC300»54DLIN 

MNS XX:C300i54 3L00 

>IN3 XX:C300»543MIR 

MNS XX:L300»543NVP 

: INS XXJC300»543NFT 

MNS XX:C300f543FAL 

MNS XX:C300»543«CM 

MNS XX:C300.54DR«T 

MNS XX:C300»543RMTACP/CLI*YES 

>CLI /INIT«RMTACP/NULL/RESTRICT/CPR-'<15><l2>/RMT>/• 

MET /S*SUIOC300»54D 

>ASN xx:=ls: 

;-loa ht:/high 

>set /sy3uic«c1»54d 

>ASN »lb: 

>INS XX:C300»543RMHACP 

MNS XX:C300»54DTLK 

>INS XX:C300.543LSN 

>INS XX:C300»54DTCL 

>asn =xx: 

>SET /UIOC5rl3 

>NCP SET SYS 

NTL — DLX Process File — Partition GEN Too Fragmented 

NTINIT — Failed To Load Process DLX 

NTINIT — Clearins System 

NCP — Set failed* operation failure 

Network Initializer function failed 
>NCP SET EXE STA ON 

NCP — Set failed* component in wrong state* System 
>8 <E0F> 
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RUN $RMD 

RSX-11M V4.1 BL35 
TASK* *IDLE* 



(ZIRCON) 124K 

FREE = SY0M118, 
DLlIDrtO 



P00L=6898. 


:7146. 


:i8. 
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:i8. 
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0*******7*******1 5******23******3 1******38******46******54***X»* 
E p CC __ C __ T . T-C— D— — D 

62******69******77******85******93******100*****108*****116***** 



15-DEC-63 15:56:12 
PARS 



cexpar:c 
excomi:c 
excoh2:c 
ldrpar:t 
ttpar :t 
drvpar:o 
syspar:t 
fcsres:c 
fcppar:d 
gen :d 
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P 
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CX T L LX 



ERRSEQ 
0. 
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LOW DSR POOL 



>NCP SHO EXE CHA 

Node characteristics as of 9-APR-82 IOJOO 

Executor node = 3 (BU3) 

Identification = DECNETP5IBLi2TRYl r Management version = 3*0.0 

Host = 3 (BU3)> NSP version = 3.2.0 

Maximum links = 15 

Routing version = 1.3.0 

Type = Routing 

Maximum address = 32 

Maximum circuits = 6» Maximum cost = 1022 

Maximum Hops = 6» Maximum visits = 12 

Verification state = On 



; RMT BU3 

Connected to "BU3 ", System type = RSX-11M 
System ID: DECNETPSIBL12TRY1 



-■ nci_i_u 

Account or name: YANUSHP0LSKY 
Password: 

RSX-11M BL32 CI, 543 System BU3 

10:01:26 Login user YANUSHPOLSKY C7,53 HT0: 

0V-APR-82 10:01 Logged on Terminal HT0: 

Good Morning 



. NCF 

NCP>L00P EXE C0U 1000 WITH MIX 
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>ACT /ALL 

LDR**. 

NETACP 

EVP... 

EVC... 

MCR ♦ * ♦ 

• • » MCR 

F11ACP 

PMT... 

RMHACP 

RMTACP 

. . .NCP 

LOO.O 

MIR.O 



>NTD 



9-APR-82 10:01:57 — Warning — Pool is critically low 
Tot3l free pool = 600. bytes 
Largest fragment = 236. bytes 

NTBEMO — Unable to connect to remote server. 

9-APR-82 10:01:57 — Low pool - Please exit active tasks - BU3 

9-APR-82 10:01:57 — Low pool - Please exit active tasks - PU3 



NCP>~Z 

>NTD 

9-APR-B2 10:02:17 Node: BU3 r DECNETPSIBL12TRY1 

Mapped* RSX-11Mp Full Routing Node Allocation 

LNKS 4/15 XXXXXXXXXX! Failures: 

CCB 0/16 

SDB 0/31 

LDB 0/53 : 

Remote Nodes: Network Tasks: 

Remote Circuit Hop/Cst Lnk/Dla Task TI Links Mbo>: XMT RCV 

evp... coo: 

RMTACP COO: 1 1 
RMHACP COO: 1 1 
. ..NTD HTO: 1 1 

ntd... coo: 1 
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>NCP SHO EXE COU 

Node counters as of 9-APR-82 10 J 03 

Executor node = 3 <BU3) 

122 Seconds since last zeroed 

262125 Bytes received 

262125 Bytes sent 

8672 Messages received 

8577 Messages sent 

4 Connects received 

4 Connects sent 

Response timeouts 

1 Received connect resource errors 

6 Total maximum logical links active 

Aged packet loss 

Node unreachable packet loss 

Node out-of-range packet loss 

Oversized packet loss 

Packet format error 

Partial routing update loss 

Verification reject 

6 Node maximum logical links active 

Total received connect resource error! 



>EXIT RMT 

RMT — Control returned to node BU3IJ 
10:04:20 Logout user L7tZl HTO: 
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INSUFFICIENT NUMBER OF NETWORK COMPONENTS 



>NCP SHOEXEC CHAR 

NCP — Command not accepted r unrecognized function or option 

>NCP SHO EXEC CHAR 

Node characteristics as of 19-DEC-83 15:42140 

Executor node = 231 (ZIRCON) 

Identification = ZIRCON_ENCRUSTED_TUEEZERSf Management version = 4.0.0 

Host = 231 (ZIRCON) t Loop count = 1» Loop length = 40 

Loop with = Hi::ed» NSP version = 4.0.0 

Maximum links = 2» Routing version ~ 2.0.0> Type * Nonrouting IV 

Maximum circuits =1 

Segment buffer size = 576> Verification state = On 



RrtT ZIRCON 

Connected to 'ZIRCON* t System type * RSX-11M 
System ID: ZIRCON.ENCRUSTEI'.TUEEZERS 



>HEL RYAN 
Password: 

RSX-UM BL35 Cli543 System ZIRCON 

19-DEC-83 13:42 Logged on Terminal HT0: 

Good Afternoon 

15M2:54 Login user RYAN C5»13 HT0: 

********************************************* 

* * 

* * 

* WELCOME ABOARD ZIRCON * 

* * 

* Any Problems? * 

* * 

* See * 

* * 

* Pete Delia Pelle * 

* * 

* Dan Ryan * 

* * 
**************x*********************x******** 



>NTD 

NT0EM0 — Unable to connect to remote server. 
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>NTD 

NTDEhO — Unable to connect to remote server. 



>NCP SHO EXEC COU 

Node counters as of 19-DEC-B3 15:43:28 

Executor node = 231 (ZIRCON) 

40 Seconds since last zeroed 

1995 Bates received 

1995 Bates sent 

261 riessases received 

261 hessases sent 

1 Connects received 
.1 Connects sent 

Response timeouts 

Received connect resource errors 

2JLsi^~ J^^?JJLE^iL%iiL2 * links activ e, 

iir~~~A2ed racket loss 

Node unreachable racket loss 

Node out-of-ranse packet loss 

Oversized packet loss 

Packet format error 

Partial routing update loss 

Verification reject 

2 Node maximum logical links active 

2 Total received connect resource errors 



•: NCP LOOP EXEC 

NCP — Loop failed? Mirror connect failed* network resources 
Unlccped cc'jr.t - 1 

>ACT /ALL 

LDR... 

RrtDEMO 

NETACP 

£VC... 

MCR... 

. ...1CF: 

FUACP 

PMT... 

RMHACP 

RMTACP 



>EXIT RMT 

RriT — Control returned to node ZIRCON:: 

15'.44:i9 Loaout user C5»13 HTO: 



■NCP 

NCP.LOQP EXEC 
NCP> 
NCP>"Z 
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>INS E300»543CFE 

>E"U 

>CFE 

Enter filename: C300»543CETAB.HAC 

CFE>LIST EXEC 

Executor characteristics as of 19-BEC-83 15:45:02 

Identification = ZIRCON_ENCRUSTED_TUEEZERS 
Name = ZIRCON» Address = 231. Host = 231 
Maximum links = 2t Maximum node counters = 4 
Type = Nonroutins IV» Verification state = On 
Sesment buffer sire = 376 

CFE>DEFINE EXEC MAX LINKS 10 

CFE>"Z 

>NCP SET EXEC STATE OFF 



Event type 68«14f Normal ussse terminated 
Occurred 19-DEC-B3 15:45153 on node 231 (ZIRCON) 
Circuit DMC-0 



Event tape 2. Of Local node state chanse 
Occurred 19-DEC-83 15:45156 on node '231 (ZIRCON) 
Reason for state change: Operator command? Old node state * On 
New node state = Off 



>NCP CLE SYS ALL 
s 

>NCP SET SYS ALL 
> 

,-NCP SET EXEC STATE ON ( 

Event type 2.0» Local node state chanse 
Occurred 19-DEC-83 15:48:13 on node 231 (ZIRCON) 
Reason for state chanse: Operator command* Old node state = Off 
New node state = On 



Event type 4.10» Circuit up 
Occurred 19-DEC-83 15M8:i6 on node 231 (ZIRCON) 
Circuit DMC-0 
Node address « 65 (RSXHUB) 



:: RMT ZIRCON 

Connected to 'ZIRCON' t System type = RSX-11M 
System ID: ZIRCON_ENCRUSTED_TUEEZERS 

>HEL RYAN 
Password: 

RSX-11M BL35 C1.543 System ZIRCON 

19-DEC-83 15M8 Losaed on Terminal HTO: 
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Good Afternoon 

15:48:34 Losin user RYAN C5j13 HTO: 

zztzzzzzztzzzzzzzzzzzzzzzzzzzzzztttttzzztzzt* 



WELCOME ABOARD ZIRCON 
Any Probleas? 
See 
Pete Dells Pelle 
Dan Ryan 



zzzzzzzzzzzzzzztztzzzzzzzzxzzzzzzzzzzzzzzzzzz 



>NTD 

19-BEC-83 15:48:46 Node: ZIRCONC 231) ZIRCON_ENCRUSTED_TWEEZERS 
RSX-11M* Non-Routins Node> DECnet V4.0 

LNKS 4/10 XXXXXXXXXXXXXXXX! Alloc Fails: 

CCB 4/9 XXXXXXXXXXXXXXXXX! 

SDB 0/11 

LI'B 4/9 XXXXXXXXXXXXXXXXX! : 



ffi-jQyj-j Circuits* 
Circuit Cost Size AdJ Node/Status 



DnC-0 



576 RSXHUB( 65) 



Network Tasks: 
Task TI Links MBX XMT RCV 



NTD... COO 

um UTA 

» • • it i v ni v 

RMHACP COO 

RMTACP COO 



1 
1 



>EXIT RUT 

RMT — Control returned to node ZIRCON! 

15:48:58 Logout user L5»13 HTO: 



BYE 
Have a Good Afternoon 
19-DEC-83 15M9 TT0: lossed off ZIRCON 
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TUNING BY MODIFYING THE GLOBAL SYMBOLS 

Usually command files for the network components (NSP, NETACP, 
and so on) contain global symbols. In some cases, by changing the 
values of these symbols, you can improve the overall node 
performance for a specific set of applications. For example, a 
command file for building the NETACP contains symbol $V2TIM that 
corresponds to the general delivery queue timeout. The default 
value for this symbol is 17 (seconds). So, if the receiver task 
could not open a mailbox within 3 seconds since the connect 
initiate message was placed by the NETACP into the general 
delivery queue, the message would be dropped by the NETACP and 
deleted from the queue. Three seconds is usually enough time to 
activate the receiver task and open its mailbox, but sometimes 
(for example, during peak load on the receiver node) it may take 
longer and connect would not occur. By modifying the value of 
$V2TIM and rebuilding the NETACP, this problem can be corrected. 

Do not change any of the global symbols unless you completely 
understand their functions. The original command file has to be 
saved, so restoration would be possible. 

The command files for building the DECnet-RSX major components 
are in^ppendix 



(• 
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CRASH DUMP AND RELATED PROBLEMS 

The common reasons for DECnet crashes are the same as for 
system crashes: 

• A privileged task with an addressing mode error could 
corrupt part of the executive 

• Wrong format in the data structure for user-written device 
drivers 

• Coding error in user-written device drivers 

• Performance degeneration due to lack of dynamic storage 
region 

• Unintended loop that uses up the dynamic storage region, 
thus locking out all other tasks including MCR 

• Corrupted task images due to erroneous QIO programs to 
disks 

• Sporadic hardware interrupts such as a long, hanging lead 
to DL11 

• Environmental problems such as electrostatics and 
temperatures that affect hardware performance 

• System software bug (you must fill in SPR) 

• Hardware problem 

• Running a task whose load will fail (for example, task 
image deleted, disk down, and so on) 

To obtain necessary information for successful crash analysis, 
the following utilities are available: 

• Crash Dump Analyzer (CDA) 

• Network Dump Analyzer (NDA) 

• Communication Executive Dump (CEDUMP) (unsupported) 
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NDA as well as CDA operates in the following manner: 

• It reads the contents of the memory dump created by the 
executive crash dump routine. 

• It then analyzes the dump in accordance with information 
contained in a combined executive/network symbol table 
file. 

• Finally, it formats and outputs the dump to a line printer 
or a listing file for your evaluation. 

CEDUMP, on the other hand, formats and outputs the CEX dump on 
the running system. 
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APPENDIX 







Important Files for DECnet-RSX 



Command files for building major DECnet-RSX components 

CEX (Communications Executive) task build command file 

OU: [300,54]CEX.TSK/-MM/-HD r MP: [300, 34]CEX/-SP, OU: [300, 54]CEX= 

IN: [130,24]CEX/LB:CEBUF1:CESCH:CETIM:CELOG1 

IN : [1 3 , 24 ] CEX/LB : CEDDMNDM : CEDLC : CELLC : CESUB 1 : CEXCM 

OU: [300,054]RSX11M.STB 

LB: [1,1]EXELIB/LB/SS 

/ 

STACK=0 

PAR =CEXPAR: 112000: 6000 

GBLDEF=DLC$OV:0 

GBLDEF=CRC$OV:0 

GBLDEF=PD$AUX:0 

GBLDEF=$CXFLG:14 

GBLDEF=$DDMAN:0 

/ 

AUX (Communications Executive Auxiliary routine LLC) task build command 

OU: [300,54]AUX.TSK/-MM/-HD,MP: [300, 34]AUX/-SP,OU: [300,54]AUX= 

IN: [131,24]AUX/LB:AXDSPP:AXBFR:AXSCH:AXSUB:AXTIM 

OU: [300,54]CEX.STB/SS. 

OU: [300,054]RSX11M.STB/SS 

/ 

STACK=0 

PAROGEN: 120000: 20000 

// 

CETAB task build command file 

OU: [300,54]CETAB.TXK/-MM/-HD,MP: [300, 34]CETAB/-SP, OU: [300, 54]CETAB= 

OU: [300,24]CETAB 

/ 

STACK=0 

PAR=CTBPAR: 0:10000 

// 

DMC DDM task build command file 

OU: [300,54]DMC.TSK/-MM/-HD,MP: [300, 34]DMC/-SP,OU: [300,54]DMC= 
IN: [131,24]DDM/LB:DMC 
OU: [300,54]AUX.STB/SS 
OU: [300,54]CEX.STB/SS 

/ 

STACK=0 

PAR=GEN: 120000: 20000 

// 



17 



DECnet-RSX NODE TROUBLESHOOTING 



NTINIT (network initializer) task build command file 

OU: [300,54]NTINIT.TSK/MM/CP/PR/-FP,MP: [300, 34]HTINIT/-SP, OU: [300, 54]NTINIT 

OU: [300,24]NTINITBLD/MP 

PRI=55 

PAR=GEN:0:0 

STACK=50 

UNITS=2 

ASG=TI:1 

GBLDEF=FE.CEX: 20000 

// 

NTL (network loader) task build command file 

OU: [300,54]NTL.TSK/MM/PR:5/SL/-FP,MP: [300, 34]NTL/-SP= 
OU: [300,24]NTLBLD/MP 

/ 

PAR=GEN:0:0 

GBLDEF=.CBIAS:0 

GBLDEF=FE,CEX: 20000 

GBLDEF=$NTCFS:0 

GBLDEF=$XSNA:0 

GBLDEF=$ASUMR:0 

GBLDEF=$DEUMR:0 

TASK=NTL... 

PRI=60 

STACK=144 

UNITS=3 

ASG=SY:1 

ASG=TI:2 

// 

EVL (event logger) task build command file 

OU: [300,54]EVL.TSK/-MM/-HD,MP: [300, 34] EVL/-SP,OU: [300,54]EVL= 
OU: [131,24]EVL/LB:EVL 
OU: [300,24]EVLDAT 
OU: [300,54]CEX.STB/SS 
LB: [1,1]EXELIB/LB/SS 

/ 

STACK=0 

PAR =G EN: 120000: 20000 

// 
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EVC (event collector) task build command file, overlaid 

OU: [300,54]EVC.TSK/PR/CP,MP: [300, 34] EVC/-SP=OU: [300, 24] EVCBLD/MP 

/ 

PAR=GEN:0:0 

TASK=EVC... 

PRI=198 

// 

NCP (network control program) task build command file for 
RSX-11M/M-PLUS 

OU: [300,54]NCP.TSK/PR:0/-FP/CP/MM,MP: [300, 34]NCP/-SP= 
OU: [300,24]NCPBLD/MP 

/ 

TASK=.. .NCP 

UNITS=8 

ASG=TI:1:2:3 

PAR=GEN:0:0 

STACK=200 

// 
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NMVACP, NMDRV (network management ACP and driver) task build command file 

NMVACP 

OU: [300, 54] NMVACP. TSK/MM/PR/-SE/-FP/CP, MP: [300, 34]NMVACP/-SP, OU: [300,54]NM 
OU: [300,24]NMVACPBLD.ODL/MP 

/ 

TASK=NMVACP 

PAR=GEN:0:0 

PRI=100 

STACK=100 

UNITS=2 

GBLDEF=$TMLUN:1 

GBLDEF=$MBLUN:2 

GBLDEF=$TMEFN:4 

The psect "$$$XXX" contains the context area buffer pool. Each simult 
user requires a 506 byte context block. Space for additional users can 
be obtained by changing the EXTSCT below and rebuilding, by installing 
the with "/INC=n", or by installing the task as checkpointable, so it 
automatically extent itself via the EXTK$ directive at run time. 

Space is originally allocated for one user. 

EXTSCT=$$$XXX:506 
/ 

NMDRV (NM:) 

OU: [300,54]NMDRV.TSK/-MM/-HD,MP: [300, 34]NMDRV/-SP, OU: [300, 54]NMDRV= 
OU: [300, 24] NMDRV, NMTAB 
OU: [300, 54JCEX.STB/SS 
LB: [1,1]EXELIB/LB/SS 

/ 

STACK=0 

PAR=GEN: 120000: 4000 

// 
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XPT (transport process LLC process) task build command file (end-node) 

OU: [300,54]XPT.TSK/-MM/-HD,MP: [300, 34]XPT/-SP, OU: [300,54]XPT= 
IN : [131,24] XPTE. OLB/LB : XPEDAT: XPTEVT: XPELIN : XPERCV: XPESUB 
IN: [131,243XPTE.OLB/LB:XPETIM:XPTRC:XPEXMT 
OU: [300,54]CEX.STB/SS 
OU: [300,54]AUX.STB/SS 
LB: [1,1]EXELIB/LB 

/ 

STACK=0 

PAR=GEN: 120000: 20000 

Define Routing parameters 

GBLDEF=PC$TH2:4 :DLC queue length 

GBLDEF=PC$IPL:6 : Input packet limiter 

// 

ECL (network services LLC process/driver) task build command file 

OU: [300,54]ECL.TSK/-MM/-HD,MP: [300, 34]ECL/-SP, OU: [300,54]ECL= 
IN: [131,24]ECLSLI/LB:ECLACK:ECLBUF:ECLCTR:ECLDAT:ECLINI:ECLPRO 
IN : [131, 24 ] ECLSLI/LB : ECLQIO: ECLRCV: ECLSLI : ECLSUB : ECLTIM : ECLUSR 
IN: [131,24]ECLSLI/LB:ECLXMT 
OU: [300,54]CEX. STB/SS 
LB: [1,1]EXELIB/LB 

/ 

STACK=0 

PAROGEN: 120000: 20000 

Define ECL parameters 

GBLDEF=LR$CNT:5 ;ECL retry count 

GBLDEF=LR$MAS: 3 /Maximum message reassembly queue 

/length 

GBLDEF=LR$LST:2 ;Link service threshold 

GBLDEF=LT$INF:12 /Outgoing connect timer 

GBLDEF=LT:LPT:36 ;ECL idle timer 
/ 

ECL (network services LLC process/driver tables) task build command file 

OU: [300,54]ECLTAB.TSK/-MM/-HD, ,0U: [300, 54]ECLTAB = 

OU: [300,24]ECLTAB 

OU: [300, 54]ECL. STB/SS 

/ 

STACK=0 

PAR=GEN:0: 1000 

// 
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NETACP (network services ACP) task build command file 

OU: [300, 54] NETACP. TSK/AC/-FP/AL/MM, MP: [300, 34]NETACP/-SP f OU: [300, 54]NETACP 

IN: [131, 24]NETACPSLI/LB:SESCON:SESCTL:SESCTR:3ESDAT:SESDIS 

IN: [131.241NETACPSLI/LB:SESDMO:SESDSP:SESINI:SESMN:SESQIO:SESPRQ 

IN: [131,24]NETACPSLI/LB:SESSLI:SESSUB:SESTCB:SESTIM:SESUSR 

LB: [1,1]EXELIB/LB/SS 

OU: [300,54]CEX.STB/SS 

OU: [300,54]AUX.STB/SS 

OU: [300,54]ECL.STB/SS,XPT.STB/SS 
i 
/ 

TASK=NETACP 

PAR=GEN:0:0 

PRI=200 

STACK=32 

UNITS=0 

GBLDEF=$V2TIM:17 

GBLDEF=N$$SMC:10- 

// 

NICE (network information/control exchange server) task build command file 
RSX-11M and RSX-11M-PLUS 

OU: [300,54]NICE.TSK/MM/PR:5/-FP/CP,MP: [300, 34]NICE/-SP= 
OU: [300,24]NICEBLD/MP 

/ 

PAR=GEN:0:0 

TASK=NIC$$$ 

UNITS=4 

STACK=100 

// 

; EVR (event receiver) task build command file 

OU: [300,54]EVR.TSK/PR/CP,MP: [300, 34]EVR/-SP= 

OU: [300,24]EVRBLD/MP 

/ 

PAR=GEN:0:0 

PRI=197 

TASK=EVR$$$ 

// 
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NTD (node state display user task) task build command file 

OU: [300,54]NTD.TSK/MM/PR/-FP/CP,MP: [300, 34]NTD/-SP= 

To allow file operations in NTD, place a semicolon before the first line 
and remove the semicolon from before the second line. 

IN: [135 r 24]NTD/LB:NTD:DISPLY 
IN: [135, 24]NTD/LB:NTD:DISPLW 

OU: [300,54]RSX11M.STB/SS 

/ 

PAR=GEN:0:0 

TASK=. ..NTD 

STACK=100 

To allow file operations in NTD, place a semicolon before this line. 

GBLDEF=$DSWRT:0 
// 

NTDEMO (Node state display server) task build command file 

OU: [300,54]NTDEMO.TSK/MM/PR/-FP/CP,MP: [300, 34]NTDEMO/-SP= 

IN: [135,24]NTD/LB:NTDEM0 

LB: [1,1]EXELIB/LB/SS 

OU: [300,54]CEX.STB/SS 

OU: [300,54]RSX11M.STB/SS 

/ 

PAR=GEN:0:0 

TASK=NTD... 

STACK=100 

UNITS=5 

EXTTSK=2700 

// 
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LIN (link watcher) task build command file 

OU: [300, 54]LIN,TSK/MM/PR/-FP/-SG/CP,MP: [300, 34]LIN/-SP= 

OU: [300,24]LINBLD/MP 

/ 

PAR=GEN:0:0 
TASK=LIN$$$ 
STACK=100 
PRI=100 
UN ITS =4 

$LTXTM - number of seconds before DLX receive times out 
$LTXRR - number of times to retry receive 

GBLDEF=$LTXTM:22 
GBLDEF=$LTXRR:5 
EXTSCT=.. POOL: 2734 
// 

LOO (loop tester) task build command file 

OU: [300,54]LOO,TSK/MM/PR/-FP/CP,MP: [300, 34] LOO/-SP, OU: [300, 54]LOO= 

IN: [135, 24] LOOP/LB : LOOPER: LOOPAR: LOOPNI 

IN: [130,24]NETLIB/LB:XXBUF 

IN: [135,24]DECMAN/LB:MAPADD:MAPNAM:TRNLOG 

IN: [130,24]NETLIB/LB:NPARS 

OU: [300,54]CEX.STB/SS 

/ 

PAR=GEN:0:0 
TASK=LOO$$$ 
PRI=100 
C TACK~ 1 00 

LBIT = BITS/BYTE including protocol overhead 
LBAU = BITS/SEC actual line speed (16 bit max) 
LLDY = Modem turnaround delay 

GBLPAT=LOOPER: LBIT: 13 
GBLPAT=LOOPER: LBAU: 454 
GBLPAT=LOOPER: LLDY: 16 
EXTSCT=. .POOL: 1000 
// 
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MIR (loopback mirror) task build command file 

OU: [300,54]MIR.TSK/MM/-FP/-SG/CP,MP: [300, 34]MIR/-SP, OU: [300,54]MIR= 

IN: [135,24]MIR/LB:MIRROR 

IN: [130, 24]NETLIB/LB:XXBUF 

/ 

PAR=GEN:0:0 

TASK=MIR$$$ 

STACK=36 

// 

NVP (network verification) task build command file 

OU: [300,54]NVP.TSK/MM/PR/CP/-FP,MP: [300, 34]NVP/-SP= 
OU: [300,24]NVPBLD/MP 

/ 

PAR=GEN:0:0 

TASK=NVP. . . 

STACK=60 

PRI=150 

UIC=[1,1] 

UNITS=3 

GBLDEF=ENCRPT:0 ;PASSWORD ENCRYPTION ROUTINE (0 = NOT USED) 

// 

NFT (network file access utility) task build command file, overlaid 

OU: [300,54]NFT.TSK/MM/CP/-FP,MP: [300, 34]NFT/-SP= 
OU: [300,24]NFTBLD/MP 

/ 

PAR=GEN:0:0 

TASK=.. .NFT 

UN ITS =6 

ASG=TI:3 

ASG=TI:4 

STACK=100 

, 

; Define NFAR parameters 

GBLDEF=$NFRSZ:1004 ;Record buffer size 

GBLDEF=$NFNMB:2 ;Buffering level 

EXTSCT=$$FSR1:7354 ;FSR extension 

GBLDEF=$TRLUN:6 ;Trace LUN 

i 

; Default directory listing width 

GBLDEF=LI$WID:110 

J 

; Define logical link timeout interval 

GBLDEF=$LLTIM:5 

// 
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FAL (Network FCS file access listener) task build command file, non-overlaid 

OU: [300,54]FAL.TSK/PR:0/MM/-FP/CP,MP; [300, 34]FAL/-SP= 
IN : [133,24] FALFCS/LB : FALFCS : FALDEF : FALFLB : FALSTB : FALS UB 
IN : [133.24] FALFCS/LB : FALACC :FALATT: PALCMP: FALCNF : FALCTL 
IN : [133,24] FALFCS/LB : FALDAT: FALDEL: FALDIR : FALDTM : FALERR 
IN : [133,24] FALFCS/LB : FALEXE : FALGET: FALGND: FALINI : FALNAM 
IN: [133, 24] FALFCS/LB :FALOPN:FALPRO:FALPCK 
IN: [133,24]FALFCS/LB:WLDPRS:WLDSUB:.CSI3 
IN: [130,24]NETLIB/LB:DIRW 

These modules are assembled during DECnet generation: 
FALBUF - Contains the buffers and per link data bases. 
FALPRM - Contains access parameters if verification is not 
supported. 

OU: [300, 24] FALBUF 
OU: [300, 24] FALPRM 
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Determine whether writing the log file "LB : [1, 4]FAL. LOG" is supported: 
FALLOG - Included only if log file is supported. 
FALDLG - Included only if no log file support. 

IN: [133, 24 ]FALFCS/LB: FALLOG 
IN: [133, 24] FALFCS/LB: FALDLG 

Determine whether tracing FAL messages to "FT: [1, 4]FAL.TRC" is supported 
FALTRC - Included only if message tracing is supported. 
FALDTR - Included only if no message trace support. 

IN: [133, 24 ]FALFCS/LB: FALTRC 
IN: [133, 24 ]FALFCS/LB: FALDTR 
/ 

PAR=GEN:0:0 
TASK=FAL. . . 
STACK=100 
UIC=[1,1] 
PRI=100 
GBLDEF=. ,D2CT:0 

Allocate number of units equal to: 
2*<number links>+4 

LUN 1 = Mailbox, LUN 2 = Trace file 

LUN 3 = Log file, LUN 4 = Scratch 

UNITS=24 

Allocate file storage region for each link. Add one if message tracing 
supported. 

ACTFIL=10 

Define "Guest" UIC. 

GBLDEF=$UICG:200 

GBLDEF=$UICU:200 

/ 

// 
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MDM (command file submission task) task build command file 

OU: [300,54]MCM.TSK/MM/PR/-FP/SL/CP,MP; [300, 34]MCM/-SP= 
IN: [133,24]FALFCS/LB:MCM 
mi. f\aa ^iiosx 1 ">M. STB 

/ 

TASK=.CMTS. 
PAR=GEN:0:0 
STACK=3 
UNITS=2 

The following assignment controls the device from which the command file 
will be submitted to Indirect. It may be changed after the task has been 
installed using the MCR command, 

>REA .CMTS. 1 xxn: 
where xxn: is the new device for command submission 

ASG=TT0:1 
// 
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RMT, RMTACP (remote network terminal user task) task build command file 

RMT 

OU: [300,54]RMT.TSK/MM/PR/CP/-FP/-SE,MP: [300, 34]RMT/-SP= 
IN: [140,24]RMT/LB:RMT 
OU: [300,54]RSX11M.STB/SS 
LB: [1, 1]EXELIB/LB/SS 

/ 

PAR=<3EN:0:0 

TASK=. . .RMT 

STACK=3 

UNITS=1 

GBLDEF=RM$HST: ;1 = allow recursive RMT usage, = disallow 

/ 

RMTACP 

OU: [300, 54] RMTACP. TSK/CP/MM/PR/-SE/-FP/CP, MP: [300, 34]RMTACP/-SP= 

OU: [300, 24] RMTACP 

IN: [140,24]RMT/LB:FMTPCD:RMTAST:RMTCCP:RMTCMD 

IN: [140,24]RMT/LB:RMTGND:RMTICP:RMTINI:RMTKCP 

IN: [140, 24]RMT/LB:RMTMCL:RMTNIO:RMTOCP:RMTRCP 

IN: [140, 24]RMT/LB:RMTRSC:RMTSRV:RMTTCP:RMTTIO 

OU: [300,54]RSX11M.STB/SS 

LB: [1,1]EXELIB/LB/SS 

/ 

TASK=RMTACP 

UNITS=11 

PAR=GEN:0:0 

PRI=99 

GBLDEF=RM$CLI:1 ;Define RMT as an alternate CLI 

// 
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RMHACP, HTDRV (network command terminal ACP/driver) task build command file 

RMHACP task build command file 
> 

OU: [300. 54] RMHACP, TSK/MM/PR/-SE/-FP/CP, MP; [300- 34]RMHACP/-SP= 
OU: [300)24]RMHACP 

IN: [140, 24]RMHACP/LB:RMHPCD:RMHAST:RMHCAC:RMHDIS:RMHGND:RMHINI:RMHSRV 
IN: [140,24]RMHACP/LB:RMHMCL:RMHNIO:RMHRCP:RMHSNK:RMHSNP:RMHTCP:RMHTMO 
OU: [300,54]CEX.STB/SS 

/ 

PAR=GEN: 0: 
TASK=RMHACP 
PRI=100 
UN ITS =6 

Define RM$PRV as U2. PRV if RMHACP is to make the terminal non-privileged 
when a new user logs on, usually defined as zero. 

GBLDEF=RM$PRV:0 
/ 
/ 

OU: [300,54]HIDRV. TSK/-MM/-HD,MP: [300, 34]HTDRV/-SP, OU: [3 00, 54]HTDRV= 

IN: [140, 24 ]RMHACP/LB: HTDRV 

OU: [300,24]HTTAB 

OU: [300,54]RSX11M.STB/SS 

LB: [1,1]EXELIB/LB/SS 

/ 

STACK=0 

PAROGEN: 120000: 4000 

// 
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TLK (network talk utility) task build command file 

OU: [300,54]TLK.TSK/MM/CP/PR:0/-FP,MP: [300, 34]TLK/-SP= 

IN : [133, 24 ]TLK/LB : TLK: TLKIMP: TLKNET: TLKPRS 

IN: [133,24]TLK/LB:TLKCRT 

IN: [133,24]TLK/LB:TLKDIA 

IN: [133,24]TLK/LB:TLKFSR 

IN: [135, 24]NTD/LB:DISPLY 

LB: [1,1]EXELIB/LB 

IN: [130,24]NETLIB/LB.GCL:QFILE 

/ 

TASK=...TLK 

STACK=100 

PAR=GEN:0:0 

PRI=50 

UN ITS =4 

ASG=TI:1:2 

TLK Dialogue Support: If you want support for this feature, you must have 
both Read-After-Prompt and Breakthrough-Write as Terminal Driver features. 
This mode will not work without both of these. 

To enable Dialogue support, place a semicolon before the GBLDEF and include 
the "TLK/LB:TLKDIA" module. To disable this support, remove the semicolon 
and do not include the module. 

GBLDEF=$DIALG:0 

TLK Video Dialogue Mode Support: If you want support for this feature, you 
must have Read-After-Prompt, Breakthrough-Write, and Attach-For-AST as 
Terminal Driver features. This mode will not work without all of these. 

To enable Video Dialogue support, place a semicolon before the GBLDEF and 
include the "TLK/LB:TLKCRT" module. To disable this support, remove the 
semicolon and do not include the module. 

GBLDEF=TLKCRT:0 

To enable Indirect Command File support, place a semicolon before the 
GBLDEF (RSX-11M/M-PLUS only) and include the "TLK/LB :TLKFSR" module. 
To disable, remove the semicolon and do not include the module. 

GBLDEF=$TLKFSR:0 

If you have an FCS Resident Library, you may wish to link to it. 

// 
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LSN (network talk server) task build command file, multi-copy 

OU: [3 00,54]LSN«TSK/MM/PR:0/-FP/CP,MP: [3 00, 34]LSN/-SP^ 
IN: [133,24]LSN2/LB:LSN:LSNSNG:LSNDLG,LB: [1, 1]EXELIB/LB 
IN: [133,24]TLK/LB:TLXCRT, [135, 24]NTD/LB iDISPLY 

/ 

TASK=LSN$$$ . 

PAR=GEN:0:0 

PRI=100 

UN ITS =3 

GBLPAT=LSN:$ASK:1 

STACK=100 

// 

TCL (remote task control server) task build command file 

OU: [300,54]TCL.TSK/MM/PR/CP,MP: [300, 34]TCL/-SP= 

IN: [134,24]NETFOR/LB:TCL 

OU: [300,24]TCLPWD 

OU: [300,54]RSX11M.STB/SS 

/ 

PAR=GEN:0:0 

TASK=TCL... 

STACK=100 

UIC=[1,1] 

UN ITS =1 . 

// 
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DLX (direct line access, LLC/driver) task build command file 

OU: [300,54]DLX. TSK/-MM/-HD, MP: [300, 34]DLX/-SP, OU: P00,54]DLX= 
IN : [1 31,24] DLX/LB : DLXCEX: DLXCHR : DLXCTL : DLXDAT: DLXLIN 
IN: [131,24]DLX/LB:DLXQIO:DLXSUB 
OU: [300,54]CEX. STB/SS 
LB: [1,1]EXELIB/LB/SS 

/ 

STACK=0 

PAROGEN: 120000: 20000 

GBLDEF=$$BUF:1170 

EXTSCT=$$$DLX:54 

/ 

DLX (direct line access, LLC/driver) tables module build command file 

OU: [300,54]DLXTAB.TSK/-MM/-HD,,OU: [3 00, 54 ]DLXTAB= 
OU: [300,24]DLXTAB 
OU: [300, 54]DLX. STB/SS 

/ 

STACK=0 

PAR=GEN: 0:1000 
// 

HLDTAB (HLD data table) task build command file 

[300, 54]HLDTAB/-HD/-MM=[300, 24]HLDTAB 
/ 

STACK=0 

PAR=XXXX: 0:10000 
// 
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INTRODUCTION 



Understanding various performance parameters for the nodes and 
network helps the specialist to control and manage the network. 
This module summarizes performance considerations for the DECnet 
network. 



OBJECTIVES 

To tune and troubleshoot the network, the specialist must be 
able to: 

• Interpret the following performance parameters: 

- CPU utilization 
Line utilization 

System and user buffer availability 

- Size/number considerations 
Throughput, response time and message rate 

• Practice the general procedures for upgrading network 
applications. 

• Use available performance information for evaluating 
network activity. 



RESOURCES 

1. Martin, James. Computer Networks and Distributed 
Processing , Part 1, Chapter 3 and 8. Englewood Cliffs, 
NJ: Prentice Hall, 1981 

2. Martin, James. Design and Strategy for Distributed 
Data Processing , Part 5, Chapter 35. Englewood Cliffs, 
NJ: Prentice Hall, -1981 
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VARIETY OF NETWORK REQUIREMENTS 

The type of network used depends on a variety of parameters 
related to : 

• Type of application 

- Airline reservation system 

- Bank loan service 

- Corporate data processing 
Common carrier service 

- Office automation 

• Cost versus response time, reliability, data integrity, and 
security 

Private or public network 

- Vertical or horizontal topology 

- Local area network 

- Switching technique 

- Multiple access to communications media 
Bandwidth 

Transport functions 

- Node coupling 

• Network growth 

- New communications media 
Geographical distribution 
New applications 
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FACTORS AFFECTING PERFORMANCE 

Factors that affect performance are grouped into the following 
categories: 

• Configuration related 

- CPU capacity 

- Communication line characteristics 

- System and user buffering levels 

- Routing 

- Multipoint 

- Ethernet 

• Application related 

- Message size and variations 
Message rate 

Peak loading design 
Application mix 
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CPU Capacity _ 

The capacity of the processor is important in determining 
whether a node can accommodate the desired load. The load must be 
able to accommodate: 

• Local processes 

• Operating system overhead 

• Communications software overhead 

• Communications interrupt processing 

Figure 1 presents a plot of CPU utilization for two different 
types of processors using the same user message size over a single 
communications line. Note the following: 

• It takes less load for a more powerful CPU to be able to 
accommodate a given network workload. 

• Neither one of the two CPU's is loaded to 100%, so any 
congestion that occurs in the system is due to the 
communications line. 

• If more than one communications line is active on a 
processor, CPU utilization increases linearly until total 
CPU utilization reaches 70%. After that, CPU utilization 
becomes more difficult to predict. 

• CPU utilization of over 70% for both network and local 
processing should be considered as a potential performance 
problem. 
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Figure 1 CPU Utilization versus User Message Size for 
Different Types of Processors 
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If two processors are connected over a communications line by 
using character-interrupt devices (DUP-11), it requires more CPU 
activity to support communications for each processor than for 
processors connected by a microprocessor-based device (DMR-II). 
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Figure 2 CPU Utilization versus User Message Size for 
Different Types of Communications Lines 
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Communications Line Characteristics 

The bandwidth of the communications line is usually less than 
that of the CPU, therefore any congestion that occurs is due to 
the communications line. The throughput, for the same 
communications line, tends to increase with the line speed up to 
the point where the line becomes saturated. Figure 3 shows the 
throughput for the same line at various line speeds. 
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Figure 3 Throughput versus User Message Size for 
the Same Type of Communications Line 



DECnet-RSX PERFORMANCE CONSIDERATIONS 



The net utilization of a line (actual useful data minus 
protocol overhead) is defined as: 

Actual User Data Rate (bits/second) 

Line Speed (bits/second) 



Figure 4 presents an example of net line utilization versus 
the user message size for a communications device driven at 
different speeds. 
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Figure 4 Net Line Utilization versus User Message Size 
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The throughput on a line can be affected by such things as 
line noise, since noisier lines require more retransmissions of 
the same data plus the same protocol overhead. 

Throughput can also be affected by half-duplex lines which are 
less than half as efficient as full-duplex due to the nonzero 
turnaround time. Relative efficiency is further reduced on a 
noisy half-duplex line because the transmitter never detects 
errors until the line is turned around. 

System and User Buffering Levels 

There are two types of buffers that need to be considered: 
system and user. System buffers are used by the operating system 
and communications software to interface with the communications 
device(s) . User buffers are allocated by the application program 
to hold data for interfacing with the operating system and 
communications software. 



System Buffers 

• The number of buffers is generally selected by a system 
(network) manager depending upon the traffic, line speed, 
and network topology. 



NOTE 
For VAX, the system (network) manager sets 
the maximum number of system buffers. The 
system returns unused buffers back to 
nonpaged pool until they are needed by the 
network. 



In general, the desired buffer level increases with heavier 
traffic, lower line speeds, and longer path length. 

If there are not enough buffers, resource errors result; 
if there are too many, space is wasted. 
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User Buffers 

• The number is specified by the user application program. 

• The desired buffer level increases with heavier traffic. 

• If memory space is tight, the buffer level can be decreased 
at the expense of increased delay. 



To achieve good throughput over the network, follow these 
rules: 

• It is desirable to have the same system buffer size across 
the network or at least on the routing nodes (see Figure 5 
for details) . 

• An average user buffer size must correspond to the system 
buffer size considering the protocol overhead in the system 
buffer. 
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If an application on node A wants to communicate with an 
application on node E, the End Communication Layer (ECL) buffer 
size is 600 bytes for that logical link. Every packet with a size 
more than 500 bytes over that logical link is discarded by the 
network as an oversized packet. 



LOGICAL LINK 




SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM 

BUFFER BUFFER BUFFER BUFFER BUFFER 

SIZE: 600 BYTES SIZE: 600 BYTES SIZE: 500 BYTES SIZE: 600 BYTES SIZE: 600 BYTES 



Figure 5 System Buffer Size in the Network 
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Figure 6 Correspondence of User to System Buffer Size 
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Figure 7 Throughput versus User Message Size 
for a Specified System Buffer Size 

Routing 

Routing loads communications lines and nodes with transport 
messages. Routing also requires a certain amount of CPU activity 
for routing a packet within a node from one physical line to 
another. Depending on the implementation of the communications 
software, routing may require more or less CPU activity on a node 
in end-to-end traffic. Figures 8 and 9 illustrate the required 
CPU activity to support DECnet routing on RSX and VMS operating 
systems, respectively. 
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Figure 8 CPU Utilization versus User Message Rate 

for DECnet-RSX 
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Figure 9 CPU Utilization versus User Message Rate 

for DECnet/VAX 
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Multipoint 

Multipoint performance is complex and is dependent on a number 
of interrelated parameters and effects: 

• For the software multipoint configuration, the CPU 
utilization of a multipoint tributary node is a function 
not only of messages per second that it exchanges with the 
control node, but also of any simultaneous conversations 
between the control node and other tributaries, 

• For multipoint configurations with low-speed lines and 
significant traffic rates to and from several slave nodes, 
lines routinely approach saturation. 

• Multipoint traffic does not make as efficient use of the 
line as point-to-point traffic, due to the increased 
polling overhead. 

Ethernet 

A major performance enhancement to DECnet is the support of 
Ethernet. Ethernet: 

• Provides a data link that can transfer data faster and with 
less host system load. than a 1 megabit DMR-11. 

• Requires a smaller number of data messages than a DMC-11 
because when two phase IV nodes communicate on the Ethernet 
the executor buffer size automatically increments to 1498 
bytes (with a DMC the executor has a buffer size of 576 
bytes) . 

• Less NSP layer messages sent back and forth between the two 
communicating nodes (due to the smaller number of data 
packets) . 
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Figure 10 Comparison of File Transfer on Ethernet and DMC-11 
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MESSAGE SIZE AND VARIATIONS 

The smaller the average message size, the lower the potential 
throughput. Since the protocol overhead does not diminish along 
with the message size, the percentage of processor or line 
bandwidth devoted to protocol increases. 

The greater the variation in the message size, the more 
degraded the performance. When message lengths vary over a long 
range f the performance tends toward the shorter messages. 

EVI6SS3Q6 FiSTw 

Processor utilization is directly proportional to message 
rate. The question is whether the CPU or the line becomes 
congested first. Figure 11 shows a typical plot for CPU 
utilization versus message rate for various line speeds. 

NOTE 
As the line approaches saturation, queue 
length increases, and the piggybacking 
feature minimizes overhead and thereby 
diminishes the processor overhead required to 
transmit or receive a message. 
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Figure 11 CPU Utilization versus User Message Rate for 

Various Line Speeds 



Peak Load Design 

A network should be designed for peak periods of the 
applications during the day, not for the total number of messages 
averaged over the number of hours the system is used. 

Applications Mix 

The mixture of applications running concurrently with the 
communications software influences network performance, 

particularly as the load increases and approaches resource 
saturation. Any code executed at elevated priority levels should 
be examined for its potential impact on the communications 
software. Any user code with heavy real-time requirements should 
also be checked. 
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MAJOR PERFORMANCE PARAMETERS 

Although a variety of factors affecting network performance 
combined with a variety of network types creates a complicated 
picture for a specific network and application, in general , the 
performance behavior can be described with just two parameters: 
net line utilization and CPU utilization. 

Net Line Utilization 

• Varies primarily with message size, flow control, full- or 
half-duplex, and noise. 

• Asynchronous communications devices are significantly less 
efficient than synchronous devices, because they require 
start and stop bits. 

• At low speeds, lines can become saturated. Piggybacking 
becomes important at this point. 

• It is measured in percent versus user message size. 



CPU Utilization 

• Both local and network processing should be considered. 

• A combined CPU utilization of greater than 70% is a clue to 
potential performance problems. 

• Varies primarily with the CPU, communications device, flow 
control, and the type of operating system. 

• Character-interrupt devices use a lot more CPU than 
microprocessor-based devices. 

• It is measured in percent versus user message rate 
(messages/second) . 
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INTRODUCTION 

New features of the DECnet-RSX software must be presented to 
customers . in accordance with DIGITAL'S marketing and support 
strategies. This module, utilizing articles from internal DIGITAL 
publications, provides summary information on the new features the 
product has, the capabilities of the product, and the pricing of 
the product along with the optional software/hardware that is 
available. Appendix A contains a copy of the SPD for each of the 
DECnet-RSX products. Information on performance of the product 
versus the previous version, and against itself is provided in 
Appendix B. 



OBJECTIVES 

Upon completion of this module the specialist should: 

• Recognize the product's limitations. 

• List the product's new features. 

• Use the available performance graphs for evaluating the 
DECnet load on a node. 

RESOURCES 

1. DECnet-RSX Phase IV Update Seminar Videotape Presentation 

2. Sales Update , October 3, 1983 

3. DECnet-llS , SPD 10.74.11 

4. DECnet-llM , SPD 10.75.11 

5. DECnet-llM-PLUS , SPD 10.66.04 

6. DECnet-RSX Version 4.0 Performance Report 
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BASIC PRODUCT DESCRIPTION 

The DECnet-RSX Phase IV products are: 

DECnet-llM, Version 4.0 

DECnet-llS, Version 4.0 

DECnet-llM-PLUS, Version 2.0 

These products run on RSX11M, Version 4.1; RSX11S, Version 
4.1; or RSX11M-PLUS, Version 2.0 respectively. 



NEW FEATURES 

• Large network support that increases the number of 
supported nodes from 255 to 1023. 

• DEUNA and DEQNA support that allows the UNIBUS and Q-BUS 
based PDP-11 systems to connect to Ethernet. 

• Extended data link services that includes the Ethernet 
protocol in addition to the existing DDCMP and X.25 
protocols. 

• DLX QIO calls using the Ethernet that allows the user to 
bypass some of the overhead associated with DECnet. 

• Enhanced network management that can support Ethernet and 
communication server products including down-line loading 
and up-line dumping over the Ethernet. 

• Phase III compatibility that allows upward migration to 
Phase IV. However, note that Phase II nodes are no longer 
supported. 



PACKAGING CHANGES 

• Full function kit that can generate either a routing node 
or an end node. 

• End node kit that is moderately priced and has less 
overhead than the standard routing node. 
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STREAMLINED NETWORK GENERATION PROCEDURE 

• PREGEN is no longer required for some users (those with 
RL02, RK06, RK07) . 

• NETGEN asks fewer questions (more defaults) . 

• NETGEN supports a standard function network (full 
component with predefined values for optional parameters) . 

• NETGEN supports extended network services for layered 
software that may be added later (heterogeneous command 
terminal support, SNA gateway access, X.25 gateway 
access) . 



NEW COMPONENTS 

• The Ethernet Protocol Manager (EPM) that controls access 
to the Ethernet. DEUNA and DEQNA are devices that support 
access to the Ethernet and therefore require EPM. 

• The End Communication Process and Driver (ECL) that 
manages all the time-critical network functions and 
accomplishes all QIO calls for user tasks. In the 
previous release this component was called NSP. 

• The Routing Process (XPT) that controls sending and 
receiving of messages from and to the local node and 
forwarding route-through packets. 

• The Routing Control Processor (RCP) that controls and 
updates the routing database for all nodes that support 
routing. 

• Direct Line Access Controller (DLX) that buffers messages 
in network buffers and supports two new Ethernet devices, 
DEUNA and DEQNA. 

• The Console Carrier Requester (CCR) task that communicates 
with Console Carrier Server (CCS) on the remote server 
node. CCR is used only for communicating with 
communication server systems. 

• The General Microcode Loader (MLD) that loads devices 
(other than KMC or KMS) with the proper microcode. 
Currently, UNA is the only device that requires MLD. 
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COMMUNICATIONS SERVERS 

Phase IV provides the following support for communications 
server systems from the host node: 

• Support for down-line loading server systems • — The 
communication server system has no disk peripherals and 
the pregenerated system is down-line loaded from a host 
system over the Ethernet. 

• Support for receiving up-line dumps from server systems — 
On system crash the server system dumps its memory image 
to: 

The host that downline loaded it. 

- A list of predefined hosts. 

Any possible hosts. 

• Support for the console carrier requester — As the server 
system has no physical console terminal, commands normally 
issued from the console now come from a host node. The 
MOP protocol is enhanced to support this feature. 

The Phase IV server products include: 

• DECnet router server 

• Terminal server 

• DECnet Router/X. 25 gateway 
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PROGRAMMING AND UTILITIES ENHANCEMENTS 

• Network File Access Routines (NFARs) 

- Record access — Support for accessing records 
randomly* 

Extended attributes — Support for resultant file 
names, full file attributes, dates and times, and 
protection. 

- Access options — Support for various access control 
options. 

• Network Display Utility (NTD) 

Resource Display Page — New format display shows 
circuits instead of remote nodes. 

Remote Node display — New display allows users to see 
up to 84 reachable nodes at one time. 

• RMS FAL 

Support for RMS-11, Version 2.0. 

- Support for multicopy and multiuser FAL on 
RSX-11M-PLUS systems. 

• Network File Transfer (NFT) 

- Attribute directory switch (/AT) — Displays a new 
directory listing format showing the file attributes. 

- Filespec logging switch (/LO) — Displays file 
specifications while NFT does the operation. 

- Automatic block mode transfer (/AX,/BK,/RC) ■ — No 
switch needed. NFT automatically defaults to block 
mode transfer if the remote node system can support 
it. 

Version number conversion — Built-in feature converts 
file version numbers from octal to decimal or decimal 
to octal. 

Improved wildcard handling — Wildcards can be 
specified in the output file specification. 
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DECnet PHASE IV FOR PDP-11s 

The Phase IV DECnet-RSX products are ready to book now. The 
DECnet-RSX products offer the major networking enhancements of 
the Ethernet and DNA Phase IV programs announced in May 1982, 
plus new pricing and new packaging to meet the needs of your 
customers. 



PRODUCT DESCRIPTION 

The DECnet-RSX Phase IV products are: 

DECnet-llM, Version 4.0 
DECnet-llS, Version 4.0 
DECnet-llM-PLUS, Version 2.0 

These software products offer large network and Ethernet 
support for the RSX-11M, RSX-11S and RSX-11M-PLUS operating 
systems. 

The DECnet-RSX products support the existing DECnet Phase III 
features such as homogeneous network command terminals, file 
transfer, network management, file access, record access, 
multipoint support, X.25 support, down-line loading and up-line 
dumping, and task-to-task communications. 

In addition, the DECnet-RSX Phase IV products offer the 
following new features as previously announced: 

• DEUNA and DEQNA support — The DEUNA and DEQNA 
(Ethernet-to-UNIBUS and Q-Bus communications controllers) 
allow PDP-11 systems to connect to Ethernet. 

• Extended data link services — Data link service now 
includes the Ethernet protocol in addition to existing 
DDCMP and X.25 protocols. 

• Routing for large networks — The routing algorithms are 
enhanced to increase the number of supported nodes in the 
network from 255 to 1023. 

• Enhanced network management — Network management now 
offers support for Ethernet and communications server 
products. This support includes loading remote systems, 
dumping memory from remote systems, initiation and 
termination of network functions, and examination and 
modification of remote unattended systems. 
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• Phase III compatibility — DECnet-RSX Phase IV offers 
Phase III features plus compatibility. This compatibility 
provides upward migration to Phase IV. 

Network command terminals are supported for DECnet-RSX host 
to DECnet-RSX host only (homogeneous support) . With this 
feature, a user at a terminal on a DECnet-RSX host appears 
directly connected to another DECnet-RSX host. In the next 
release of DECnet-RSX, this feature will be extended to other 
hosts supporting heterogeneous network virtual terminals. 



SELLING STRATEGY 

Customers can invest in the future now. The DECnet-RSX 
products offer flexibility for evolution to large networks and 
migration to Ethernet with the same software. Configuration 
flexibility allows the user to reconfigure as the network 
expands. 

The DECnet-RSX Phase III compatibility feature provides 
insurance for existing customers by offering: 

• Migration for applications developed on Phase III nodes 

• Connectivity of Phase III nodes to Ethernet by using Phase 
IV nodes and to the Phase IV network 

• Phased migration to Phase IV networks and Ethernet 



PACKAGING 

The new packaging for DECnet-RSX products offers more options 
to meet the needs of your customer. The new packaging includes 
the new End-Node Kit and the separation of installation service. 

Kits 

Two types of nodes may be generated using the DECnet-RSX 
products. The two types are routing nodes and end nodes. The 
routing node can initiate a message, be a destination for a 
message or be a transit point for messages passing through to the 
destination node (local or remote) . The end node can initiate a 
message or be a destination for a message. The end node cannot 
be a transit point for messages passing through to the 
destination node. 



FOR INTERNAL USE ONLY 



DECnet-RSX PRESALES SUPPORT 



Two types of DECnet-RSX kits are now available: the Full 
Function (Routing Node) Kit and the new End-Node Kit. 

The Full Function Kit generates either a routing node or an 
end node. The Routing Node provides cost-efficient flexibility 
for the customer who purchases one total kit and multiple 
license-only kits. 

The End-Node Kit is competitively priced and has less 
overhead than the standard routing node. The End-Node Kit meets 
the needs of the customer who requires the cost-effective 
solution for low-end application processing. For example, in an 
Ethernet LAN the lower priced end node is available for 
application processing. This offers the customer a 
cost-effective LAN solution. If routing is required, the routing 
node handles any routing overhead. 



SERVICE OFFERINGS 

DIGITAL-supported prices are reduced. Software installation 
is unpackaged from software warranty. The DECnet-RSX supported 
license customer receives a software license, distribution media, 
and 90 days of warranty support. Software warranty begins. after 
software product installation and includes: telephone support, 
software product updates, software performance report responses, 
and critical on-site remedial support for identified program 
error after all remote services are exhausted. 

Installation service is recommended for new customers and 
existing customers who are unfamiliar with DECnet installations. 
Installation services are delivered by your local office 
specialist and include: preinstallation preparation assistance, 
site and software verification, installation verification and 
check-out, review of the product operation, and a documentation 
set. 

In addition to installation services, software product 
services are currently available (Self-Maintenance, Basic and 
DECsupport) . Customers currently in warranty or on either of 
Software Product Services receives DECnet-llM, Version 4.0; 
DECnet-llS, Version 4.0; or DECnet-llM-PLUS, Version 2.0 at no 
additional charge. 
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Customers who are not in warranty and do have a service 
contract may purchase the appropriate H-Kit. 



NOTE 
In-warranty and Software Product Service 
customers receive the full-function software 
distribution. 



PREREQUISITE SOFTWARE 

RSX-11M, Version 4.1; RSX-11S, Version 4.1; or RSX-11M-PLUS, 
Version 2.1 is a prerequisite for DECnet-llM, Version 4.0; 
DECnet-llS, Version 4.0; or DECnet-llM-PLUS, Version 2.0, 
respectively. 



PRICING AND LITERATURE INFORMATION 

To provide a single reference source, pricing and literature 
information for most of the products announced in this issue 
follows. 

If there are any questions concerning this information, 
contact the individual Product Manager or Distributed Systems 
Marketing. 
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Table 1 Product Information 



Product 
Order Number 



Description 



Discount 
E/U OEM 



Product 1 
Availability 



Ethernet Hardware 

DEUNA-AA 

DEQNA-KP 

DEQNA-M 

CK-DEQNA-KA 
CK-DEQNA-KB 
CK-DEQNA-KC 



DELNI-AB 
DELNK-A* 



DEREP-AA,AB 
DEREL-A* 



DEREP-RA,RB 
DEREK-R* 



Ethernet to UNIBUS Conm Controller 

Integrated Q-Bus to Ethernet 

Controller 

Base Module M7504 Q-Bus to 

Ethernet 

Cab Kit for DEQMA-M in 11/23-S 

Cab Kit for DEQNA-M in Micro/PDP-11 

Cab Kit for DEQNA-M in M/23-PLUS 

Ethernet Transceiver Qty 1-99 

Qty 100-499 
Qty 500 + 

Ethernet Local Network 
Interconnect 
Ethernet LNI - non-U. S. 
DELNI Country Kit 

Ethernet Local Repeater 

Country Kit for Ethernet Local 

Repeater 

Ethernet Remote Repeater 

Country Kit for Ethernet Remote 

Repeater 



$3,500 


Call F.S. 


Y 


1 


1,150 


Call F.S. 


Y 


1 


1,000 








150 
150 
150 








300 
250 
200 


DECmailer 
only 






985 

985 

10 


Call F.S. 


Y 


1 


1,500 


Call F.S. 






12 
4,400 


Call F.S. 







NOW 

Q3/FY84 
Q3/FY84 
Q3/FY84 



NOW 
OCTOBER 



MARCH 1984 
MARCH 1984 



'Several Country Kit Variations are available. 

Ethernet Communications Servers 

16-Line Terminal Server 
32-Line Terminal Server 
Terminal Server S/W 

(The Terminal Server information is included for planning purposes only. Specific price, availability, and 
ordering information will be supplied upon announcement.) 



14. 


,000(T) 


135(T) 


Y 


2 


Next major 


20, 


,000(T) 


225(T) 


Y 


2 


release of 


1, 


,000(T) 




Y 


2 


VMS 



DECSA-EA 
Q*725-Ax 
01727-Ax 
Q1728-AX 
QI728-DZ 



Comm Server Upgrade Kit 

One-Line Router or X. 25 Gateway 
DECnet Router Server S/W 
DECnet Router/X.25 Gateway S/W 
X.25/X.29 Extension Package 
X.25/X.29 Ext Package License Only 



4,750(T) 


90(T) 


13,500 


183 


3,500 




3,500 




2,200 




1,500 





Q3/FY84 
03/FY84 
Q3/FY84 
Q3/FY84(VAX) 



* - C-ll/730, D-ll/750, E-ll/780, P-RSX 
! - C-ll/730, D-ll/750, E-ll/780 
x » media 
T » Targer 



1. These prices are for the U.S. Area only. Pricing in other areas will be determined by the area managers. 

2. Dates listed here are worldwide product availability dates. 
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Table 1 Product Information (Cont) 



Product 
Order Number 



Description 



Discount 
E/U OEM 



Product 2 
Availability 



Ethernet Coasunications Servers (continued) 



QLA01-DZ 

DECSA-AH 
DECSA-AM 
DECSA-DZ 

DCSAX-LA 
DCSAX-LB 
DCSAX-LC 

DECnet-RSX 
Full-Function Node 



Generic Server S/W License Only 

SNA Gateway, S/W on RL02 (VMS) 

SNA Gateway, S/W on 1600bpi MTa (VMS) 

SNA Gateway w/License-to-Copy S/W 

One Line Sync Card 19. 2K bps 
One Line Sync Card to 500K bps 
Two Line Async Card to 19. 2K bps 



Qj76*-Ax 
QJ76*-DZ 

* « 2-11S, 4-llM, 6-11M-PLUS 
End Node 

QJ76*-Ax 
QJ76*-DZ 

* - 3-11S, 5-liM, 7-11M-PLUS 

DECnet/VAX 
Full-Function Node 



Supported license, media and 
90-day warranty (least cost stedia) 
License-to-Copy "A" Kit 



Supported license, media and 
90-day warranty (least cost media) 
License-to-Copy "A" Kit 



Q*D05-Ax 
Q*D05-DZ 

* - C-ll/730, D-ll/780, E-ll/780, 11/782 
End Node 

Q*D04-Ax 
O*D04-DZ 

* - C-ll/730, D-ll/750, E-ll/780, 11/782 



Supported license, media and 
90-warranty (least cost media) 
License-to-Copy "A" Kit 



Supported license, media and 
90-day warranty (least cost media) 
License-to-Copy "A" Kit 



OBSERVER VI. 1 
QSP40-AD 
QSP20-AD 
QSP20-DZ 



OBSERVER-PLUS Supported 
OBSERVER Supported 
OBSERVER License Only 



26,995 
26,995 
25,795 



415 
650 
375(T) 



4,150 
2,950 



1,950 



3,950 
2,950 



1,450 
950 



15,000 

12,000 

9,000 



135 
135 
135 



N/A 



N/A 



N/A 



N/A 



N/A 



Q2/FY84 
Q2/FY84 
Q2/FY84 



Q3/FY84 



Q3/FY84 



Q3FY84 

Q3/FY84 

03/FY84 



1. These prices are for the U.S. Area only. Pricing in other areas will be determined by the area 

2. Dates listed here are worldwide product availability dates. 
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Table 1 Product Information (Cont) 



Product 
Order Number 



Description 



A/0 
Change 



Q*725-AM 
Q*725-AH 
Q*725-HZ 



Q1727-AM 
Q1727-AB 
Q1727-HH 
01727-HM 
01727-HZ 
QI728-AG 
QJ728-HG 
0i728-AY 
Q1728-HY 
QI728-HZ 
DECSA-AH 
QSF01-SZ 
QJ732-HX 
QJ732-HZ 
QE452-ZY 
Q1452-AG 
QM52-HG 
Q1452-HY 
QI452-HZ 
QE453-AY 
Q1453-AX 
QI453-HG 
QI4S3-HZ 
QI453-HY 
QE4 54-AY 
Q*4 54-AG 
QE4 54-HY 
Q*4 54-HG 
Q*454-HZ 
0E4 55-AY 
Q*4 55-AG 
QE455-HY 
Q*455-HG 
Q»455-HZ 
0J76»-AX 
QJ76*-AX 
QJ76*-AX 
QSF02-SZ 
Q*D04-AX 
Q*D05-AX 



DECnet Router Server S/W 
DECnet Router Server 
DECnet Router RTC Upd 
Terminal Server S/W 
Terminal Server S/W 
Terminal Server RTC Upd 
DECnet Router/X.25 Gateway S/W 

DECnet RTR/X. 25 Gateway Upd RL2 
DECnet RT/X.25 Gateway Upd Magtape 
DECnet Router X. 25 RTC Upd 
X. 25/X.29 Extension Package (VMS) 
X.25/X.29 Extension Package Upd TU58 

X.25/X.29 Extension Package Upd RX01 
X.25/X.29 Extension Package RTC Upd 
SNA Gateway, S/W on RL02 
SNA Gateway Installation Service 
DECnet/SNA Gateway Upd N/S 
DEcnet/SNA Gateway RTC Upd 
DECnet/SNA Gateway Magtape 
DECnet/SNA Gateway Magtape 
DECnet/SNA Gateway Magtape N/S Upd 
DECnet/SNA Gateway Magtape N/S Upd 
DECnet/SNA Gateway Magtape RTC Upd 
DECnet/SNA RJE 
DECnet/SNA RJE 
DECnet/SNA Upd N/S 
DECnet/SNA RJE RTC Upd 
DECnet/SNA RJE Upd N/S 
DECnet/SNA VMS 3270TE 
DECnet/SNA VMS 3270TE 
DECnet/SNA VMS 3270TE Upd 
DECnet/SNA VMS 3270 Upd 
DECnet/SNA VMS 3270 RTC Upd 
DECnet/SNA VMS Appl Int. 
DEcnet/SNA VMS Appl Int. 
DECnet/SNA VMS API Upd 
DECnet/SNA VMS API Upd 
DECnet/SNA VMS API RTC Upd 
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NOTE 
Prices are for low cost media (floppy) . the above 
prices are for U.S. Area only. Prices in other 
areas will be provided by the local Software 
Services Manager. 

A 5% discount is available to customers who prepay for a year's service. Prerequisites for SPS are a license for 
the appropriate Communication Server and/or software product license for the appropriate host operating system, an 
SPS contract for the host operating system and SPS contract for the appropriate Communication Server and/or software 
product. 



G « TU58, Y - RX01, X - RX02, H « RL02, M - 9-track 1600 magtape 

1 - C-ll/730, D-ll/750, E-ll/780 

• - C-ll/730, D-ll/750, E-ll/780, P-RSX 
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APPENDIX A 
Performance Report 

INTRODUCTION 
Configurations 

RSX-DECnet 4.0 performance measurements were obtained using 
various configurations. The following chart illustrates the 
devices and processors used to gather data for this report: 

Table 2 Configurations 

Device 
Processor UNA 1 Meg DMC* 56 K DMC 

11/24 — > 11/24 X X X 

11/44 — > 11/44 X X X 

11/24 — > 11/750 X X X 

11/44 — ■> 11/750 XX X 

*The DMC and DMR communications devices perform the same. The 
terms will be used interchangeably in this report. 

All configurations consisted of an end node communicating with 
a routing node, except the 11/44 — > 11/44 combination. Both end 
node — > end node and routing node — > routing node tests were run 
with this configuration. 

Two RL02s were used for all tests except those to VMS. One 
RL02 contained the RSX Version 4.0 operating system, and the other 
contained DECnet and the performance tools. The VAX did not have 
RL02 drives. An RK07 was used for both the operating system and 
DECnet. 
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Methodology 

Two types of data were collected for this report. 
Task-to-task communication was measured by using 3 minute DTS/DTR 
echo tests. File transfer times were obtained by using NFT 
commands,, surrounded by "show time" commands. A background drone 
task, which incremented registers at a known rate, was installed 
at a lower priority than both NFT and DTS/DTR. By running the 
drone and the tests simultaneously, one could calculate CPU 
utilization, CPU time/message and CPU time/block. 

DTS/DTR gives the user statistics on the tests performed. The 
baud rate mentioned in this report refer to these numbers. 
DTS/DTR does not include overhead in its statistics. Therefore, 
the term "baud rate" refers to the number of user bits/seconds 
transmitted and received. The term "line utilization" describes 
the percentage of the line filled with user bits. It is defined 
as the quotient of the number of user bits/seconds traveling 
through the line divided by the line speed (times 100%). The 
"true" baud rate and line utilizations were actually higher than 
those quoted here. Please read about DTS/DTR graphs in Section 
1.4. 

Measurements were taken using NFT transfer commands. ASCII 
files of known lengths were transferred from a local node to a 
remote node ("pushed") and then from the remote node to the local 
node ("pulled"). Had the files transferred been image files, and 
not ASCII files, less CPU time would have been needed to copy them 
because image files do not need to be formatted, whereas ASCII 
files do. Each series of NFT tests was done twice: once with RMS 
FAL installed on the remote node, and once with FCS FAL installed 
on the remote node. 

CPU Power and Baud Rates 

Throughout this report, performance will be described in terms 
of CPU utilization, CPU cost/message and baud rate. CPU 
cost/message is defined as the amount of CPU time (in 
milliseconds) divided by the sum of the number of messages 
transmitted and received. The other two concepts are defined 
above. 
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The amount of CPU time spent by a system is directly 
proportional to its CPU utilization. In other words, holding the 
CPU utilization of a system constant is equivalent to holding the 
CPU time spent by a system constant. If the CPU is the bottleneck 
in a system, a task with a low CPU cost/message will perform 
better (or in the case of DTS/DTR tests, have a higher baud rate) 
than a task with a high CPU cost/message. This is true because 
CPU time is the limiting factor with respect to performance. The 
more "CPU efficient task" will have better performance than the 
less "CPU efficient task", 

The same relationships hold true when comparing 
configurations. If two configurations have the same CPU types and 
they are both saturated, one can explain why one system has a 
higher baud rate than the other by knowing their CPU 
costs/message. The baud rate of the configuration with the 
cheaper CPU cost/message will be higher than the baud rate of the 
system with the more expensive CPU cost/message. In this study, 
the communications line often accounts for a difference in CPU 
cost/message between configurations. 

The configuration with the lower CPU cost/message does not 
always have the higher throughput. Processor types have different 
instruction speeds. An 11/24 with a 50% CPU utilization cannot do 
as much as an 11/750 with a 50% CPU utilization. Even if the RSX 
system had a cheaper CPU cost/message than the VAX, it would 
probably be outperformed by the faster processor. If two 
configurations have identical processors, and one uses more of its 
CPU power on a task than the other, it may compensate for its 
higher CPU cost/message. By using more CPU time for the task than 
the other system, the less "CPU efficient" configuration may 
perform better. 

System Buffer Sizes 

One should take into account the relationship between the user 
message size and the large system buffer size when tuning a 
system. There are (at worst) 18 bytes of overhead in a DECnet 
message. Therefore, the sum of the user user message size +18 
should be as close to the system buffer size as possible. This 
will avoid the fragmentation of messages. If "n" is a positive 
integer, and "buffsize" is the decimal number of bytes in the 
large system buffer, then the following formula describes the 
critical user message size: 

user message size = [n X {buf f size-18) ] 
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If the user message size is even one byte larger than this 
critical value, an extra DECnet message will be needed for each 
user message transmitted. There will be a sharp degradation in 
performance at these points, as measured by user throughput and 
CPU utilization. This phenomenon creates the staircase effect 
seen in Graphs 1 and 2. 

All the DTS/DTR graphs in this report should follow these 
generic shapes. As one approaches a critical user message size, 
performance improves. Once one passes it, there is a sharp 
decline followed by a steady increase in performance until the 
next critical user message size is exceeded. For simplicity's 
sake, the graphs have been drawn as straight lines. 

All system buffer sizes were set to 576 bytes. Preliminary 
tests were also run with buffer sizes of 518 and 1484 bytes. The 
results did not warrant the inclusion of the data in this report. 
Except for the expected differences in performance at the user 
message size of 512 bytes, due to the staircase effect mentioned 
earlier, the results were similar with all three system buffer 
sizes. 
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DECnet 4.0 
Point-to-Point Results 

DTR/DTS Results — As expected, the 11/44 — > 11/750 configuration 
provided the highest throughput of ail the processor combinations, 
followed by the 11/44 — > 11/44, the 11/24 — > 11/750 and the 
11/24 — > 11/24 (see Chart 1 and Graph 3). 

It is interesting to note that the 1 Meg DMC often performs 
better than the UNA. In order to understand this, one must 
realize that the CPU cost/message of the UNA is usually higher 
than the CPU cost/message of a DMC (see Graph 4) . When CPU time 
is the limiting factor in performance, the device with the 
cheapest CPU cost/message will provide the highest throughput. 
This explains why the 1 Meg DMC gives a higher baud rate than the 
UNA in the 11/44 — > 11/750 and 11/44 — > 11/44 configurations. 
It also explains why the UNA gives better performance than the 1 
Meg DMC in the 11/24 — > 11/750 configuration (the UNA's CPU 
cost/message iss lower than the DMC's cost/message in this case.) 
The 11/24 — > 11/24 configuration seems to be the only exception 
to this rule. Upon closer inspection, one sees that the 11/24 — > 
11/24 CPU utilization drops off after the 512 byte user message 
size when a 1 Meg DMC is used (see Graph 5). This drop in CPU 
utilization does not occur with a UNA (see Graph 6) . Note that 
the 1 Meg DMC is "outperformed" (in terms of throughput) exactly 
at this point (see Graph 3), Therefore,- even though the CPU 
cost/message of the UNA is higher than that of the 1 Meg DMC, the 
higher CPU utilization of the processor with the UNA more than 
compensates for this fact. 

Graphs 7 and 8 plot baud rate as a function of user message 
size. each graph depicts data for a specific processor. ll/24s 
can transmit 105K bits/second through an Ethernet while ll/44s can 
transmit more than 160K bits/second through the line. 

Graph 9 plots line utilization as a function of user message 
size. All configurations using an Ethernet had line utilizations 
well under two percent and therefore were not included in this 
graph. As one would expect, the 56K DMC lines were the most 
heavily utilized. The configurations obviously have line 
utilizations proportional to their baud rates. The limiting 
factor of all devices, except the 56K DMC, does not appear to be 
line speed. The limiting factor is CPU power. 

**This excludes the 56K DMC cases, which are limited by line 
speed, not processor speed. The 11/24 — > 11/750 Ethernet 
configuration is an exception which will be explained later. 
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No significant differences in baud rate and CPU utilization 
were found between the end node — > routing node configuration and 
the routing node — > routing node configuration. The data from 
these two experiments have therefore been combined in this report. 

NFT Results — Chart 2 shows the time needed to transfer files 
between two nodes for various processors and devices. It is no 
surprise that the fastest configurations include the 11/750, and 
the slowest file transfers took place on the 11/2 4s. The 
processor speeds account for this, along with the differences in 
VMS FALs and RSX FALs . 



RMS FAL versus FCS FAL — All NFT tests were run to both an RMS 
FAL and an FCS FAL, except those which transferred files to and 
from the 11/750. VMS does not support FCS FAL. In every 
configuration, except one, file transfers to and from a system 
with the FCS FAL installed were faster than those to and from a 
system with RMS FAL installed (see Graph 10 and Chart 2). This is 
because the RSX FCS FAL is simpler and smaller than the RSX RMS 
FAL. The RMS FAL supports more functionality than the FCS FAL, 
and is therefore bigger and slower. The VMS RMS FAL is very fast, 
however, because it uses a lot of memory for buffering, and it 
queues its writes. Graphs 11 and 12 plot the CPU utilizations of 
various processors against file size. 

Usually the bottlenecks in the file transfers are the CPUs. 
This is obviously not the case all the time. The 56K DMC lines 
were the limiting factor when they were used. If two systems are 
finely tuned, the disk speed becomes a factor in performance. In 
these tests, the RL02s tended to fill up, and time was wasted 
looking for free blocks to use. 

Push versus Pull — In all configurations involving an RSX system 
and a VMS system, "pushes" (local — > remote file transfers) were 
faster than "pulls" (remote — > local file transfers) . This is 
due to the fact that RMS on VAX uses more buffering than RMS on 
RSX, when writing to its files. It is faster to write to a VMS 
system than an RSX system because the VMS "writes to disk" are 
queued (see Chart 2) . 
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In most RSX — > RSX configurations "pushes" are slower than 
"pulls", at least for file sizes under 512 blocks. The only two 
exceptions to this are 1) the 11/24 — > 11/24 communicating over 
the Ethernet with RMS FAL installed and 2) configurations using a 
56K DMC. The 56K line gets saturated. Neither CPU time nor 
buffering levels are the bottlenecks in this case. "Pushes" and 
"pulls" take virtually the same amount of time and CPU power. 

Routine Node versus End Node — When two routing nodes communicate 
with each other, NFT file transfers take longer than if an end 
node talks to a routing node. Only 11/44 — > 11/44 configurations 
over a 1 Meg DMC and the Ethernet were tested (see Graphs 13 and 
14). 

Route-Through Results 

Route-through tests were done with the following 
configurations : 

1 Meg DMC UNA 

1) 11/44 fc-11/4 4 ►11/750 

1 Meg DMC UNA 

2) 11/44 ^11/2 4 ►11/750 



DTS/DTR Results — It is clear that the bottleneck in the second 
configuration is the 11/24's CPU. The CPU utilization reaches 
90%, in the case of a 1 byte user message size (see Graph 15). 

It is interesting to note that the 11/24 routing node 
consistently uses between 44 and 47 percent more CPU time/message 
than the 11/44 routing node (see Graph 16) . Similarly, the 11/24 
uses between 23 and 32 percent more of its CPU than the 11/44. 
The 11/44 routing node can transmit 25 percent more user 
bits/second than the 11/24 routing node. 

the baud rate of the route-through 11/44 — > 11/44 — > 11/750 
configuration is approximately 1/3 slower than that of an 11/44 
— > 11/750 configuration (over a 1 Meg DMC) . The baud rate of the 
11/44 — > 11/24 — > 11/750 configuration is slightly faster than 
that of the 11/24 — > 11/750 configuration (over a UNA), 
suggesting that the 11/24 can route messages quite a bit faster 
than it can originate the transmission of messages. 
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As expected, a large message size yields a higher user baud 
rate than a small message size, because overhead is a constant 
regardless of message size until the fragmentation of messages 
occurs (see Graph 17) . 

NFT Results — As in the case with task-to-task communication, the 
11/24 routing node uses substantially more CPU time/message than 
the 11/44 when transferring files (see Graph 16). The 11/24 
routing node uses fifty percent more CPU time than the 11/44 
routing node to perform its routing function, when "pushing" files 
from a local to a remote node. In the case of a transfer from a 
remote node to a local node, the 11/24 uses between 1/3 and 2/3 
more CPU than the 11/44 (see Graphs 18 and 19). 

Three Node Ethernet Configuration 

Three nodes were connected to a private Ethernet. The 11/44 
sent messages to the 11/24, the 11/24 communicated with the 11/750 
and the 11/750 talked to the 11/44. In other words, the three 
nodes talked in a circle to each other. The bottleneck in the 
DTS/DTR experiment was not the line, but the 11/24 CPU. It always 
had a CPU utilization of over 99% (see Graphs 20 and 21). 
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DECnet 4.0 VERSUS DECnet 3.1 
DTS/DTR Results 

DECnet 3.1 yields a higher user baud rate than DECnet 4.0 in 
every configuration tested except the 11/44 — > 11/750 (see Graphs 
22 and 23) . The difference in user baud rates becomes more 
pronounced as the user message size increases. 

When looking at DTS/DTR performance, three main factors must 
be considered: CPU speed, CPU utilization and line speed. In a 
stand-alone environment, one would always prefer the highest baud 
rate possible, regardless of the CPU cost/message. In a multiuser 
situation, the CPU cost might be critical and one might compromise 
speed for CPU time. The following paragraphs discuss these 
factors as they relate to the configurations studied. 

Two 11/2 4s communicating over a 56K DMC line perform almost 
exactly the same under DECnet 3.1 as under DECnet 4.0. The higher 
CPU cost/message of DECnet 3.1, compared to DECnet 4.0, is 
counterbalanced by its higher CPU utilization (see Graph 24). 

Echo tests between two 11/2 4s over a 1 Meg DMC line show that 
a higher throughput can be obtained under DECnet 3.1 than under 
DECnet 4.0. Although the CPU time/message of DECnet 4.0 is lower 
than that of DECnet 3- 1. the older version uses a much higher 
percentage of its CPU power to overcome this difference. The baud 
rates on the 1 Meg line exceeded three times the baud rates on the 
56K line, for large user message sizes. The CPU utilizations were 
between two and three times higher on the 1 Meg line than on the 
56K line. 

Two ll/44s connected by a 1 Meg DMC have similar user baud 
rates for user message sizes under 512 bytes. Version 4.0 then 
has significantly higher user baud rates than Version 3.1. The 
CPU cost/message for user message sizes larger than 256 bytes is 
cheaper for the Phase IV DECnet than for the old DECnet (see Graph 
25). Therefore, because the CPU utilizations are fairly close in 
value, DECnet 4.0 performs better than DECnet 3.1 for large user 
message sizes, and worse than DECnet 3.1 for small user message 
sizes. 

The significant difference between 11/24 configurations and 
all the other configurations tested was the incredibly high CPU 
utilization (98+%) of the processor. 
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DECnet 3.1 outperforms DECnet 4.0 for all message sizes, but 
the difference in performance becomes more significant when user 
message sizes are 512 bytes or larger. Here, the CPU cost/message 
of DECnet 3.1 is substantially lower than that of DECnet 4.0. 

The 11/44 — > 11/750 configuration using a 1 Meg line is worth 
noting for several reasons. It yields the highest user baud rate 
of all the configurations tested (approaching 221K user 
bits/second). Also, it is the only configuration where DECnet 4.0 
clearly is faster than DECnet 3.1, although the CPU cost/message 
is higher. For a change, DECnet 4.0 uses more of its CPU power 
than DECnet 3.1, and therefore has a higher user baud rate. 

NFT Results 

DECnet 4.0 is slightly faster than DECnet 3.1 when doing local 
to remote file transfers between two 11/2 4s over a 56K DMC line 
(see Graph 26). Although the newer DECnet version has a higher 
CPU cost/block than DECnet. 3.1, its higher CPU utilization 
compensates for this (see Graph 27). As user files get larger 
than 512 blocks, the line speed becomes the limiting factor, not 
the CPU speed. Notice how the CPU utilization slows its rate of 
increase once the line becomes heavily used. 

In the 11/24 — > 11/24 configuration, using a 1 Meg DMC line, 
DECnet 4.0 is slower than DECnet 3.1. This is not due to a 
difference in CPU cost/block transferred. It is caused by the 
higher CPU utilization of DECnet 3.1 compared to DECnet 4.0 (see 
Chart 3) . Therefore, even when the CPU cost/block is higher using 
DECnet 3.1 than 4.0, its higher processor use overcomes this 
(except in 1 block file transfers) . 

In some cases, such as communication between two ll/44s and an 
11/44 and an 11/750, over a 1 Meg line, the CPU cost/block is 
cheaper for one DECnet version than another. Because there is no 
significant difference in CPU utilization between the two DECnets, 
the version with the cheaper CPU time/block is faster (see Graph 
28). Therefore, when two ll/44s are doing file transfers, DECnet 
4.0 is slower than DECnet 3.1. If an 11/44 is transferring files 
with an 11/750, DECnet 3.1 is faster than DECnet 4.0. 
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DECnet 4.0 VERSUS DECnet 2.1 
DTS/DTR Results 

DTS/DTR tests confirm that DECnet 4.0 and DECnet 2.1 have 
similar performance capabilities in task-to-task communication. 
DECnet M and DECnet M+ user baud rates and CPU times/message are 
within 10% of each other. DECnet 4.0 usually has a slightly 
higher user baud rate and uses slightly less CPU time/message than 
DECnet 2.1 (see Graph 29). 

NFT Results 

NFT tests show a marked difference in file transfer times 
between DECnet M and DECnet M+. DECnet 2.1 is anywhere between 
7-50% faster than DECnet 4.0 (see. Chart 4), DECnet M tends to use 
less CPU time/block than DECnet M+ r except when small (< 128 
blocks) files are moved (see Graphs 30 and 31). 
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Table 3 Three Minute DTS/DTR ECHO Tests 





Contm . 


Mess. Size 






CPU /mess. 


Processors 


Device 


(bytes) 


Baud 


CPU Util. 


(ms/mess.) 


11/24 — >ll/24 


UNA 


1 












128 


21053 


69.4 


16.84 






256 


44637 


75.72 


17.37 






512 


75912 


67.82 


18.3 






1024 


62376 


36.93 


24.24 


11/24— >ll/24 


56K DMC 


1 


128 


54.89 


16.49 






128 


10443 


34.38 


16.83 






256 


15072 


25.29 


17.18 






512 


18432 


19.25 


21.39 






1024 


21480 


13.89 


26.57 


11/44 — >ll/44 


UNA 


1 


240 


73.8 


12.18 






128 


29672 


73.16 


12.62 






256 


47634 


60.17 


12.96 






512 


92573 


62.37 


13.79 






1024 


162579 


70.42 


17.74 


11/44 — >ll/44 


56K DMC 


1 


160 


37.73 


9.19 






128 


12128 


2.62 


9.54 






256 


16792 


16.03 


9.78 






512 


20736 


10.3 


10.17 






1024 


22752 


7.34 


13.22 


11/44 — >ll/44 


1 Meg DMC 


1 


371 


83.96 


8.94 






128 


43661 


83.04 


9.74 






256 


77637 


75.09 


9.9 






512 


125520 


65.18 


10.62 






1024 


196544 


67.01 


13.96 


11/24 — >ll/750 


UNA 


1 


208 


99.14 


18.52 






128 


27427 


99.14 


18.5 






256 


51317 


99.14 


19.78 






512 


105309 


99.14 


19.28 






1024 








11/24 — >ll/750 


1 Meg DMC 


1 


296 


98.14 


13.04 






128 


35595 


99.14 


14.23 






256 


73701 


99.14 


13.77 






512 


98304 


99.14 


20.66 






1024 


126675 


98.7 


31.86 
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Table 3 Three Minute DTS/DTR ECHO Tests (Cont) 





Co mm. 


Mess. 


Size 






CPU/mess. 


Processors 


Device 


(bytes) 


Baud 


CPU Util. 


(ms/mess.) j 


11/44— >ll/750 


UNA 


1 








i 






128 




403 


96.24 


9.64 






256 




98877 


98.7 


9.981 






512 




169488 


98.83 


10.23 






1024 




na 


98.37 


11.89 


11/44— >ll/750 


1 Meg DMC 


1 




477 


93.22 


7.87 






128 




61227 


96.09 


8.03 






256 




109749 


89.37 


8.34 






512 




187325 


84.09 


9.18 






1024 




220725 


84.81 


15.74 
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Table 5 DECnet 4.0 versus DECnet 3*1 
NPT Pile Transfers (PCS FAL) 





"PUSH" 


(Local -> Remote) 






"PULL" 


(Remote -> 


Local) 




Configuration and 


Pile Si 
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CPU/Block 
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Time 
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DECnet Version 
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table 5 DECnet 4,0 versus DECnet 3«1 
NFT File Transfers (PCS FAL) (Cont) 





"PUSH" (Lo 


cal -> 


Remote) 






"PULL" 


(Remote -> Lo 


cal) 




Configuration and 


Pile Size 


Time 




CPU/Block 


CPU/Util. 


Line Util. 


Time 
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Line Util. 


DECnet Version 
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(Seconds) 


(msec/bl.) 


1%) 
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s) (1) 
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Table 6 DECnet Version 4.0 versus DECnet Version 2*1 
(DECnet M versus DECnet M-Plus) 
NFT Pile Transfers (FCS FAL) 





"PUSH" (Local -> Remote) 






"PULL" 


(Remote 


-> Local) 




Configuration i 


and Pile Size 


Time CPU/Block 


CPU/Util 


. Line Util. 


Time 


CPU 


Util. Line Util. 


Line Util. 


DECnet Version 


(Blocks 


(Seconds) (msec/bl.) 


(%) 


(%) 


(Second 
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DECnet 4.0 
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.007 
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1.08 
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128 


9 .05 


43.57 
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.03 


46.01 


.629 
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12 .027 


56.22 


.85 


12 


.027 


57.29 
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DECnet 2.1 
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3 .81 


26.7 
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28.4 
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60.32 
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.874 
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67.14 
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51.1 


8.74 




512 


14 .015 


53.87 


14.63 


19 


.021 


57.45 


11.23 




1024 
















DECnet 2. 1 


1 


3 .65 


21.75 


.137 * 


3 


.926 


30.88 


.137 




128 


7 .03 


52.52 


7.15 


6 


.026 


52.43 


8.27 




256 


11 .026 


61.23 


9.53 


10 


.023 


61.55 


10.85 




512 


19 .024 


65.82 


11.04 


17 


.023 


67.95 


12.1 




1024 


35 .024 


69.98 


12.1 


33 


.023 


70.12 


12.71 


DMA 
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DECnet 4.0 


1 


4 .846 


19.52 


.01 


3 


1.3 


38.87 


.012 




128 


7 .431 


60.03 


.766 


9 


.039 


57.95 


.605 




256 


10 .026 


70.04 


1.02 


14 


.034 


62.77 


.749 




512 


19 .026 


70.92 


1.1 


25 


.032 


65.37 


.85 




1024 


35 .026 


77.17 


1.21 


47 


.032 


66.74 


.89 


DECnet 2.1 


1 


3 .75 


22.54 


.012 


2 


.73 


31.25 


.018 




128 


6 .028 


6.72 


.93 


6 


.033 


69.35 


.87 




2 56 


9 .025 


68.82 


1.12 


9 


.029 


79.88 


1.12 




512 








17 


.028 


86.15 


1.26 




1024 
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Description 



PRODUCT NAME: DECnet-1 1 M, Version 4.0 
RSX-1 1 M Network Software 



SPD 10.75.11 



DESCRIPTION: 

DECnet-11M allows a suitably configured RSX-1 1M sys- 
tem to participate as a routing or non-routing (end) node in 
DECnet computer networks. DECnet-1 1M is a Phase IV 
network product and is warranted for use only with sup- 
ported Phase III and Phase IV products supplied by 
DIGITAL. 

DECnet Phase iV networks can contain up to 1 023 nodes 
given proper network planning. Phase III nodes participat- 
ing in Phase lll/IV networks are limited to the Phase III 
routing capability of 255 nodes. Phase II nodes are not 
supported. 

DECnet-11M offers task-to-task communications, utilities 
for network file operations, homogeneous network com- 
mand terminal support, and network resource-sharing 
capabilities using the DIGITAL Network Architecture 
(DNA) protocols. DECnet-1 1M communicates with adja- 
cent nodes over synchronous and asynchronous commu- 
nication lines, Ethernet Local Area Networks (LANs) and 
parallel interfaces. Communications using X.25 circuits 
over selected Packet Switched Data Networks (PSDN) is 
also possible. This requires DECnet-1 1 M to be configured 
with RSX-1 1 PSI/M product. Refer to the RSX-1 1 PSI/M 
SPD (10.42.xx) for further information. Access to DECnet- 
1 1 M is supported for RSX-1 1 M user programs written in 
MACRO-11, FORTRAN IV, FORTRAN-77, BASIC- 
PLUS-2, and COBOL. 

The functions available to an RSX-1 1M user depend, in 
part, on the configuration of the rest of the network. Each 
DECnet product offers its own level of functionality and its 
own set of features to the user. Networks consisting 
entirely of DECnet-1 1M nodes can have the full functio- 
nality described in this SPD. Networks that mix DECnet- 
1 1 M nodes with other DECnet products can limit the func- 
tions available to the DECnet-1 1M user because some 
DECnet-1 1M features are not supported by all DECnet 
products. Some supplied optional features require hard- 
ware configurations -larger than the minimum supported 
systems. 

The DECnet products and functions available to users on 
mixed networks can be determined by comparison of the 
SPDs for the component products. 

Adaptive Routing 

Adaptive routing is the mechanism by which one or more 
nodes in a network can route or forward messages 
between another pair of nodes in the same network. This 



routing capability will forward such messages even if no 
direct physical link exists between the pair of nodes apart 
from the sequence of physical links that includes the rout- 
ing nodes. 

A DECnet-1 1M node must function as a routing node 
whenever multiple lines are used simultaneously by that 
node. DECnet-1 1M end nodes provide all the capabilities 
of DECnet-1 1 M routing nodes except that end nodes can- 
not route messages on behalf of other nodes in the net- 
work. Since end nodes do not route messages, they do 
not need to store or update routing databases. Conse- 
quently, end nodes use less system resource and gener- 
ate less network traffic than routing nodes. 

For this same reason, end node operation consumes less 
processing power than routing node operation. The Full 
Function DECnet-1 1M software must be installed on a 
node in order for that node to operate as a routing node. 
For a node to operate as an end node either the Full Func- 
tion or the End Node DECnet-1 1M software must be 
installed on that node. Full Function DECnet-1 1M soft- 
ware allows a node to be set up as either a routing node or 
as an end node. 

Although two adjacent routing nodes can be connected by 
more than a sln n !e n h v/ sics! '.ink 






oayco win UC SCril 

over only one of the links. All other lines will serve as "hot 
standbys," such that the least cost path available between 
two nodes is the one that will be used for message traffic. 
A line cost parameter set by the system manager deter- 
mines the line over which all messages will be sent from 
node to adjacent node. 

Task-To-Task Communication 

Using DECnet-1 1 M, an RSX-1 1 M user program written 
in MACRO-1 1 or one of the supported high level lan- 
guages can exchange messages with other network 
user programs. These two programs can be on the 
same node or on any other Phase III or Phase IV node 
in the network. The messages sent and received by the 
two user programs can be in any data format. 

The DECnet-1 1 M software will optionally verify the access 
control privileges of a task requesting communication with 
a DECnet-1 1M task. The RSX-1 1M System Account File 
is used to determine access privileges. The results can 
either be passed on to the receiving task or used to reject 
the request by the network software. 
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Network Resource Access 

File Transfer Utilities 

Using DECnet-1 1 M utilities, a user can transfer sequential 
ASCII files between DECnet nodes. Files can be trans- 
ferred in both directions between the locally supported 
RSX-11M File Control System (FCS) devices and the file 
system of other DECnet nodes. Wild cards can be used 
for the user identification code, file name, file type and ver- 
sion number for local to remote file transfers. Transfer of 
other file types is supported provided the source and des- 
tination DECnet systems support the same file type. 
Directory listings" are also a supported DECnet-HM 
feature. 

The DECnet- 1 1 M file transfer utilities support file transfers 
for both FCS and RMS files, where formats are compati- 
ble between the DECnet nodes. 

Additional facilities allow system command files to be sub- 
mitted to a remote node where the list of commands is in a 
format acceptable to the node responsible for the execu- 
tion. DECnet-1 1M also allows RSX-1 1.M command files to 
be received from other systems and executed. 

A utility is also provided with DECnet-1 1M which allows 
the user to queue file operation requests for execution at a 
specified time. The user has the ability to monitor, list, and 
delete entries from this queue. 

Network users must specify the appropriate user identifi- 
cation and password in order to access the files on a 
DECnet-1 1 M node. Access to local files using the DECnet 
software can be controlled through the RSX-1 1M System 
Account File. 

F/7e Access 

File access is supported to and from remote DECnet sys- 
tems by explicit subroutine calls in the supported high 
level languages. READ, WRITE, OPEN and CLOSE, and 
DELETE operations can be initiated by local tasks for 
sequential and random access files residing on the local 
system or at remote DECnet systems. Other nodes sup- 
porting File Access can exercise this capability for files 
located on the RSX-1 1M node. Fixed and variable length 
record formats are supported. Files accessed remotely 
can contain either ASCII or binary information. 

Access to RMS file organizations from other DECnet pro- 
ducts is supported by DECnet-1 1 M. 

Network Command Terminal 

DECnet-1 1M provides a utility that allows a terminal user 
to establish a virtual connection to another Phase IV 
DECnet-1 1M or DECnet-1 1M-PLUS system. This con- 
nection makes the terminal appear as if it were physically 
connected to the other system and the operator can use 
standard system and network utilities supported by that 
system. This utility is particularly useful for doing remote 
program development and allows terminal users on small 
application oriented systems to utilize the resources of lar- 
ger development oriented systems. 

DECnet-1 1M also provides an unsupported utility that 
allows a terminal user to establish a virtual connection to 
Phase lll/IV DECnet-VAX systems. This utility is provided 
only as a courtesy from DIGITAL, with no implied support 
services offered, as is the case with other mentioned 
DECnet-1 1M-PLUS capabilities. 



Down-Line System Loading 

Initial memory images for DECnet-1 1S nodes in the 
network can be stored on RSX-1 1 M file system devices 
and loaded into nodes across point-to-point, multi- 
point (DMP/DMV only) and Ethernet links. Load 
requests can come from the local RSX-1 1 M operator or 
from the remote node. Generation of initial memory 
images of DECnet-1 1S systems for down-line loading 
is supported by RSX-1 1M. 

Upline Dumping 

Memory images of adjacent RSX-1 1S nodes connected 
by DECnet can be written onto a file on a DECnet-1 1M 
system. This facility helps a programmer understand what 
may have caused the RSX-1 1 S system to crash. 

Down-Line Task Loading 

Programs to be executed on DECnet-1 1S nodes in the 
network can be stored on the DECnet-1 1M system and 
loaded on request into DECnet-1 1S nodes. In addition, 
programs already executing on DECnet-1 1S nodes can 
be checkpointed to the host file system and later restored 
to main memory of the DECnet-1 1 S node. These features 
simplify the operation of network systems that do not have 
mass storage devices. 

Network Management 

The Network Control Program (NCP) performs three pri- 
mary functions: displaying statistical and error informa- 
tion, controlling network components, and testing network 
operation. These functions can be performed locally or 
executed at remote Phase IV nodes that support this fea- 
ture. In either case, the output resulting from a command 
can be directed to a local file or to the users terminal. 

An operator can display the status of DECnet activity at 
the local node and other Phase IV nodes. The user can 
choose to display statistics related to both node and com- 
munication lines, including data on traffic and errors. The 
local console operator can also perform many network 
control functions such as loading and unloading DECnet 
components, starting and stopping lines, activating the 
local node, and down-line loading DECnet-1 1S systems. 

DECnet-1 1M also provides local network event logging to 
the console device, a remote node, or a user written pro- 
gram. The NCP utility can be used to enable and disable 
the logging of specific events as well as to enable and dis- 
able the event logging facility. 

Communications 

DECnet-1 1M, supports the DIGITAL Data Communi- 
cations Messages Protocol (DDCMP) for full- or half- 
duplex transmission in point-to-point and multipoint opera- 
tion using serial synchronous or asynchronous facilities. 
DDCMP provides error detection/correction and physical 
link management facilities. In addition, an auto-answer 
capability is provided. 

Multipoint and auto-answer function with ElA-type devices 
only. Parallel communication devices use special link pro- 
tocols (not DDCMP) optimized for their characteristics. 

The DEUNA, when used in conjunction with the H4000 or 
DELNI transceiver, allows DECnet-1 1M to utilize Ethernet 
as a data link transmission medium. 

RSX-1 1 PSI/M is the software product that provides an 
interface to X.25 Packet Switched Data Networks. When 
DECnet-1 1M is used in conjunction with RSX-1 1 PSI/M, 
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DECnet-11M can utilize the PSDN as though it was a 
standard dataiink to transmit messages between DECnet 
nodes. 

The maximum number of physical links that can be sup- 
ported by a DECnet- 1 1 M node is sixteen depending on 
CPU memory, type of communications interface, and 
speed of interfaces. 

A maximum of 32 X25 virtual circuits is supported when 
DECnet-11M is used in conjunction with RSX-11 PSI/M 
for DECnet communication through an X.25 PSDN. How- 
ever, when the total number of DECnet circuits (DLM and 
other) is greater than 24, the maximum node address sup- 
ported is less than 1023 (#circuits * maximum address 
<25,000). 

DECnet-1 1 M multipoint will support up to a maximum 
of twelve tributaries on a single multipoint line. Aggre- 
gate bandwith of tributaries is limited to that of the 
control station device. The communication path to 
each tributary counts as a circuit with respect to the 
limits on number of circuits specified above. Multipoint 
line configurations are supported for the following 
devices: 



Multipoint Devices 





Multipoint 


Multipoint 




Control 


Tributary 


Devices 


Station (Master) 


(Slave) 


DL11/DLV11 


YES 


YES 


DUP11 


YES 


YES 


DU11/DUV11 


YES 


YES 


DPV11 


YES 


YES 


DZ11/DZV11 


YES 


NO 


KMC11 (DZ11) 


YES 


NO 


KMC11 (DUP11) 


YES 


YES 


DV11 


YES 


YES 


DMP11* 


YES 


YES 


DMV11* 


YES 


YES 



'Multipoint communication hardware device 



Direct Line Access 

User written MACRO-11 tasks will be provided with 
Direct Line Access (DLX) support to all supported 
devices (including Ethernet Controller). DLX will allow 
direct control of the communications lines, bypassing 
the logical link control and transport mechanism pro- 
vided by the DECnet software. User programs will be 
required on both ends of the link in order to use this 
interface. 

Modification of the generation procedures is required to 
generate DLX-only nodes. This interface is useful in appli- 
cations where the user desires to have minimum protocol 
overhead on a physical link and does not require the logi- 
cal link management and other network services provided 
by the DECnet software for a particular line. 



DECnet-1 1M Configuration 

The process of configuring a DECnet-1 1 M node is based 
primarily on trade-offs of cost, performance, and functio- 
nality, within the realm of satisfying the user's application 
requirements. It can be readily expected that network 
applications will run the full gamut from low-speed, low- 
cost situations to those of relatively high performance and 
functionality. The performance of a given DECnet node is 
a function not oniy of the expected network traffic and 
resultant processing ("global" conditions), but also of the 
amount of concurrent processing specific to that node 
(local conditions). Thus, node performance depends on 
many factors, including: 

• CPU type and Memory Size 

• Number of device interrupts per unit time 

• Communication line characteristics 

• Number and size of buffers 

• Message size and frequency of transmission 

• Local applications 

• Size and frequency of route-through traffic 

Note that the rate at which user data can be transmitted 
(throughput) over a communications line may sometimes 
approach, but will never equal or exceed, the actual line 
speed. The reason is that the actual throughput is a func- 
tion of many factors, such as the network application(s), 
topology, protocol overhead and line quality, as well as 
the factors cited above. 

NOTE: Careful analysis is required when configuring 
routing nodes with 1 24K words or less. 

Five basic groups of communications interfaces are pre- 
sented in the tables below. They differ in many respects, 
particularly in their effect upon CPU utilization. 

• With character interrupt devices such as the DUP1 1 , 
CPU cycles are required for not only the line protocal 
processing such as DDCMP or the optional X.25 proto- 
col, but also for each character sent and received. 

• Devices such as the DV1 1 are direct memory access 
(DMA) devices. Since DDCMP is in the PDP-1 1 soft- 
ware, CPU cycles are required for DDCMP line protocol 
processing. 

• Devices such as the DMC1 1 , DMR1 1 , DMP1 1 , DMU1 1 , 
and KMS1 1 are direct memory access (DMA) devices. 
The line protocol is executed in microcode, thus off- 
loading the PDP-1 1 CPU. The only DECnet load the 
processor sees is completed incoming and outgoing 
messages. 

• The PCL1 1-B is a high speed DMA device which uses 
local parallel communications lines. It has its own line 
protocol and does not use DDCMP. CPU cycles are 
only required for processing of incoming and outgoing 
data messages and to perform control functions. 

• The DEUNA, unibus to Ethernet controller, is a high 
speed DMA controller supporting CSMA/CD protocol. 
CPU cycles are only required for processing of incom- 
ing and outgoing messages. 
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Device Groups 



Device Group 



Maximum Line Speed 
(Kilobits/sec) 



Character 
Interrupt 

DL11/DLV11 
DUP11/DPV11 
DU11/DUV11 
DZ11/DZV11 



9.6/4.8 
9.6(1 )/4.8 
9.6(1 )/4.8 
9.6 



DMA 

DV11 

KMC11 (DZ11) 
KMC11 (DUP11) 
KMS11-BD/E* 



9.6 
9.6 
19.2 
19.2 



DMA/DDCMP 

DMC11-AR-DA 

DMC11-AR-FA 

DMC11-AL-MD 

DMC11-AL-MA 

DMR11-AA 

DMR11-AB.AC.AE 

DMP11-AA, DMV11-AA 

DMP11-AB.DMV11-AB.AC 

DMP11-AE.AC 



19.2 

56.0 

56.0 

1000.0 

19.2 

1000.0 

19.2(2) 

56.0 

1000.0(3) 



Parallel 

PCL11-B 



4000.0 



Ethernet 

DEUNA 



10000.0 



"Optional, requires the RSX PSI'M product. 
1 4 8K bps for 1 1 24 processor 
2. Up to 56 OK bps tor RS423-A interfaces 
3 500X bps for Mi-duplex 



These tables describe the physical hardware configura- 
tions supported by DECneMIM in terms of CPU class 
and communication interface device group. It should be 
noted that the attachment of such devices as A/D convert- 
ers and timesharing terminals can reduce the maximum 
number of communication lines which can effectively be 
supported. When used with RSX-1 1 PSI/M, the number of 
devices supported on any CPU will be dictated by the lim- 
its supported by the PSI product (see SPD 10.42.xx). 

It is strongly recommended that DECnet-HM be confi- 
gured as an end node if it is used on a Micro/PDP-1 1 . 



NOTE: In the following table, the rated bandwidth is stat- 
ed for a single device type. The maximum band- 
width for an intermix of device types cannot be 
calculated from these tables. 



Maximum Line Configurations oiv,11/23 
11/23-PLUS, MICRO/PDP-11" CPUs 



Device 
Group 



Character 
Interrupt 



Max. No. 


Maximum Modi 


of Lines 


Device 




Bandwidth 




(Kilobits/sec) 


8 


14.4 FDX 


8 


28.8 HDX 



DMV11* 



112.0 



FDX.HDX 



'Not supported on 1 1/23 
"Requires RL02 configuration for system and network generation. 



Maximum Line Configurations on 
11/24,11/34,11/40,11/45,11/55,11/60 CPUs 



Device 


Max. No. 


Maximum 


Mode 


Group 


of Lines 


Device 

Bandwidth 

(Kilobits/sec) 




Character 


8 


14.4 


FDX 


Interrupt 


8 


28.8 


HDX 


DMA 


8 


30.6 


FDX 




8 


61.2 


HDX 


DMA/DDCMP 








DMC11-AR-DA 


16 


307.2 


FDX.HDX 


DMC11-AR-FA 


6 


336.0 


FDX.HDX 


DMC11-AL-MD 


6 


N/A 


FDX,HDX 


DMC11-AL-MA 


2 


N/A 


FDX.HDX 


DMR11-AA 


16 


307.2 


FDX.HDX 


DMR11-AB-AC-AE 


6* 


336.0 


FDX.HDX 


PCL11-B 


1 


N/A 


Parallel 



DEUNA 



2" 



10000 



Ethernet 



'Two at 1Mbps One at 1Mbps for 11/24 
"Supported on 1 1 24, 1 1 34A only. Must be on Independent Ethernet Networks 

Maximum Line Configurations On 
11/44 and 11/70 CPUs 



Device 


Max. No. 


Maximum 


Mode 


Group 


of Lines 


Device 

Bandwidth 

(Kilobits/sec) 




Character 


8 


19.2 


FDX 


Interrupt 


8 


38.4 


FDX 


DMA 


16 


40.8 


FDX 




16 


81.6 


HDX 


DMA/DDCMP 








DMC11-AR-DA 


16 


307.2 


FDX.HDX 


DMC11-AR-FA 


6 


336.0 


FDX.HDX 


DMC11-AL-MD 


6 


N/A 


FDX.HDX 


DMC11-AL-MA 


1 


N/A 


FDX.HDX 


DMR11-AA 


16 


307.2 


FDX.HDX 


DMR11-AB-AC-AE 


6* 


336.0 


FDX.HDX 


PCL11-B 


1 


N/A 


Parallel 


DEUNA 


2** 


10000 


Ethernet 



"One al 1M bps for 1 1 44 1 1 70 

"Only one DEUNA on 1 1 70 CPU. must be independent Ethernet networks 
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Maximum Line Configurations Guidelines 
(Multipoint) 

Maximum Line Speed 
(Kilobits per Second, half- or full-duplex) 



Device Group 


19.2 


56 


250 


500 


1000 


DMV11-AA 


2/8 


2/8 








-AB 


2/8 


2/8 








-AC 


2/8 


2/8 








DMP11-AA 


+ 4/8 


2/8 








-AB 


+ 4/8 


2/8 








-AC 


2/8 


1/12 


1/12 


1/12* 




-AE 


+ 4/8 


2/8 


1/12 


1/12 


1/12* 



'half -duplex 

+ 1 1 /24 is limited to 2 controllers 



NOTE: Left side of slash (/) indicates number of control- 
lers per node and right side indicates total num- 
ber of tributaries per control node. 

Total number of circuits not to exceed 16 per 
node. 

Number of tributaries on lines should be carefully 
configured for performance considerations. 

in order to achieve a viabie configuration, the user and/or 
a DIGITAL software specialist must perform a level of 
application analysis which addresses the factors above. In 
the preceding tables, the columns have the following 
meanings: 

Maximum Number of Lines - The largest number of phys- 
ical lines that can be attached and driven by the DECnet- 
1 1 M system. 

Maximum Device Bandwidth — The maximum total num- 
ber of bits per second which can be handled by a CPU 
when all communication devices of a single given type, 
such as character interrupt, are added together. For 
example, DECnet-11M on a PDP-11/44 can accommo- 
date two half-duplex character-interrupt devices at 
19.2Kb, or eight at 4.8 Kb, or eight at 2.4 Kb (constrained 
by the maximum number of lines rather than bandwidth). 
Maximum device bandwidth should be calculated for all 
lines known to operate concurrently. Maximum bandwidth 
on a multipoint line is limited to that supported by the Con- 
trol Station device. 

Maximum Line Speed - The fastest clock rate at which the 
device can be driven under DECnet-1 1 M. If specific devic- 
es have the ability to operate at a maximum rate, they 
must be configured subject to the "maximum device band- 
width" restriction above. 

Mode - This indicates whether the line is operating in 
either half-duplex (a single bit stream) or full-duplex (two 
concurrent bit streams) mode. In some instances in the 
tables, a half-duplex line is quoted as having maximum 
bandwidth approximately double that of the comparable 
full-duplex line. This reflects the single bit stream charac- 
ter of half-duplex lines, and the fact that two of them place 
a load on the CPU roughly equivalent to one full-duplex 
line with traffic in both directions. 



MINIMUM HARDWARE REQUIRED: 

Any valid RSX-1 1 M system configuration with: 

• The following additional memory available. 
DECnet-1 1 M end node - 1 6KW 
DECnet-1 1 M routing node - 1 8KW 

DECnet-1 1 M end node with RSX-1 1 PSI/M - 22KW 
DECnet-1 1M routing node with RSX-1 1 PSI/M - 30KW 
Ethernet sunnort will add 3KW to the above memon/ 
requirements 

• The following additional number of disk blocks available 
for DECnet-1 1 M network software 

DECnet-1 1 M end node - 4000 

DECnet-1 1 M routing node - 4500 

DECnet- 1 1 M end node with RSX- 1 1 PSI/M - 4500 

DECnet-1 1 M routing node with RSX-1 1 PSI/M - 5000 

• PDP 1 1/24, PDP1 1/44, or PDP1 1/70 central processor 
with one of the following communications devices: 
DUP1 1 -DA low-speed synchronous interface (5) 

DU1 1-DA low-speed synchronous interface (4) 
DMC11-AR-DA remote synchronous V.24/EIA RS-232- 
C interface (4) 

DMC11-AR-FA remote synchronous V.35/DDS inter- 
face (4) 

DMC1 1-AL-MD high-speed local synchronous interface 
(4) 

DMC1 1-AL-MA high-speed local synchronous interface 
(4) 

DMP11-AA synchronous UNIBUS interface RS232-C/ 
RS423-A(5) 

DMP11-AB synchronous UNIBUS interface CCITT 
V.35/DDS (5) 

DMP1 1-AC local synchronous UNIBUS interface (5) 
DMP1 1-AE synchronous UNIBUS interface RS422 (5) 
DMR11-AA synchronous UNIBUS interface RS232-C/ 
CCITTV.24(5) 

DMR11-AB synchronous UNIBUS interface CCITT 
V.35/DDS (5) 

DMR1 1-AC local synchronous UNIBUS interface (5) 
DMR11-AE synchronous UNIBUS interface RS449/422 
(5) 

DL11-E asynchronous EIA interface with modem con- 
trol (5) 

DL1 1-C/WA asynchronous 20mA current loop interface 
(1,5) 

DZ1 1-A/B multiline asynchronous EIA interface (2,5) 
D211-C/D multiline asynchronous 20mA current loop 
interface. (1,2,5) 

DV1 1-AA/BA multiline NPR synchronous interface (2,5) 
PCL11-B multiple CPU link 
DEUNA Unibus to Ethernet controller 
KMS11-BD/E, synchronous UNIBUS multiplexer inter- 
face (3) 

• PDP 1 1/23, 1 1/23 Plus or Micro/PDP-1 1 central proces- 
sor with one of the following communications devices. 
(Micro/PDP-11 Configuration must include RL02 for 
system and network generation.) 

DMV11-AA synchronous QBus interface RS232-C/ 
RS423A (5) 

DMV1 1 -AB synchronous QBus interface V.35/DDS for 
11/23 PLUS (5) 
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.JQMV1 1~AC local synchronous QBus interface for 1 1/23 
PLUS (5) 

DUV1 1.-DA low-speed EIA synchronous interface (5) 
EJfcVi 1-E asynchronous EIA interface with modem con- 
trol (5) 

DLV11-F asynchronous 20 mA current loop interface 
(1,4) 

DZV1 1 -B multiline asynchronous EIA interface (2,5) 
DPV11-DB synchronous QBUS interface (5) 

NOTES: 

(1) Requires eith*" the H319 option for optical isolation or one side of the 
20mA line to be in passive mode. 

(2) All lines on this interfacejmust be dedicated as DECnet links. 

(3) Requires RSX-1 1 PSI M product. 

(4). These products are no longer marketed by DIGITAL and may not be 

supported in future releases of DECnet- 1 1 M. 
(5]i ,Or FCC eqivalent hardware option 



OPTIONAL HARDWARE: 

• Additional lines and/or communication interfaces (as 
- listed above) up to maximum as defined in Maximum 

Line Configurations tables for mapped systems. 

• KG 11 -A Communications Arithmetic Element (may be 
used in conjunction with DV1 1 , DZ1 1 , and DL1 1 ) 

• KMC11-A (without the RSX-1 1 PSI/M product, can be 
used in conjunction with up to eight DUP1 1s or with up 
to a sixteen line DZ1 1 ) 

PREREQUISITE SOFTWARE: 

RSX-1 1 M Operating System 

Refer to the RSX-1 1M Optional Software Cross Refer- 
ence Table (SPD 20.98.xx) for the required version. 

OPTIONAL SOFTWARE: 

COBOL 81 

FORTRAN-77/RSX 

PDP-1 1 BASIC-PLUS-2 for RSX-1 1 M 

RSX-1 1 PSI/M 

SOFTWARE WARRANTY 

Warranty for this software product is provided by DIGITAL 
with the purchase of a license for the product. There is no 
additional charge. This software product is warranted to 
conform to the Software Product Description (SPD). This 
means that DIGITAL will remedy any nonconformance 
when it is reported to DIGITAL by the customer during the 
warranty period. 

The warranty period is ninety (90) days. It begins when 
the software is installed or thirty (30) days after delivery to 
the end user, whichever occurs first and expires ninety 
(90) days later or one hundred eighty (180) days after 
release of a subsequent version of the software. 

Warranty Service 

DIGITAL provides software warranty service worldwide. 
Service is provided in the country of purchase and is not 
transferable between countries. 

DIGITAL will provide a service location which will accept 
reporting (in a format prescribed by DIGITAL) of a non- 
conformance problem caused when using the licensed 
software under normal conditions as defined by the SPD. 
DIGITAL will respond to a nonconformance problem in the 



current unaltered release of the licensed software by 
issuing correction information such as: correction docu- 
mentation, corrected code, or notice of availability of cor- 
rected code; or a restriction or a bypass. The customer will 
be responsible for the preparation and submission of the 
problem report to the service location. 

Warranty Exclusion 

DIGITAL DOES NOT WARRANT THAT THE SOFT- 
WARE LICENSED TO CUSTOMER SHALL BE ERROR 
FREE, THAT THE SOFTWARE SHALL OPERATE WITH 
ANY HARDWARE AND SOFTWARE OTHER THAN AS 
SPECIFIED IN THIS SPD, THAT THE SOFTWARE 
SHALL SATISFY CUSTOMERS OWN SPECIFIC 
REQUIREMENTS, OR THAT COPIES OF THE SOFT- 
WARE OTHER THAN THOSE PROVIDED OR AUTHO- 
RIZED BY DIGITAL SHALL CONFORM TO THE SPD. 

DIGITAL MAKES NO WARRANTIES WITH RESPECT 
TO THE FITNESS AND OPERABILITY OF MODIFICA- 
TIONS NOT MADE BY DIGITAL. 

IF THE SOFTWARE FAILS TO FUNCTION FOR REA-! 
SONS STATED ABOVE, THE CUSTOMERS WARRAN- 
TY WILL BE INVALIDATED AND ALL SERVICE CALLS 
WILL BE BILLABLE AT THE PREVAILING PER CALL 
RATES. 

INSTALLATION 

Only experienced customers should attempt installation of 
this product. DIGITAL recommends that all other custom- 
ers purchase DIGITAL'S Installation Services. These servj-3 
ices provide for installation of the software product by an. 
experienced DIGITAL Software Specialist. 

DIGITAL'S Installation Services can be purchased as av 
separate service. - , 

Installation Services 

For a fixed price a DIGITAL Software Specialist will 
assure that 

the customer's system is ready for installation, install the 
software, and familiarize the customer with its operation. 

Installation for DECnet-1 1 M will consist of the following:' 

• Verification that all components of DECnet-1 1M have 
been received. 

• Verification that the necessary versions of the RSX- 
1 1 M software and documentation are available. 

• Verification of the appropriate sysgen parameters. 

NOTE: Should a software specialist be required to modify 
the previously installed operation system param- 
eters, a time and materials charge will apply. 

• Install DECnet-1 1 M software 

• Define and create a local node DECnet database. 

• Modify the system's start-up command procedure 
including starting up the DECnet-1 1 M network. 

• Verify the proper installation of DECnet-1 1 M by running 
a series of tests to show connectivity (demonstrated by 
the use of the post installation checkout procedure) to a 
designated node. < 

Connectivity to all other nodes within the network is the 
responsibility of the customer. 
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Pre-lnstallation Procedures Required 

Before DIGITAL can install the software, the customer 
must: 

• Ensure that system meets the minimum hardware and 
software requirements (as specified in the SPD.) 

• Obtain, install and demonstrate as operational any 
modems and other equipment and facilities necessary 
to interface DIGITAL'S communication equipment. 

• For multi-node networks designate one adjacent node 
to verify installation/connectivity. 

• Make available for a reasonable period of time, as 
mutually agreed upon by DIGITAL and the customer, all 
hardware communication facilities and terminals that 
are to be used during installation. 

Delays caused by any failure to meet these responsibil- 
ities will be charged at the prevailing rate for time and 
materials. 

COURTESY INSTALLATION SERVICE: This software 
product will be installed by DIGITAL at no additional 
charge if you purchase Installation Service for the host 
Operating System and you install both software products 
concurrently. 

ORDERING INFORMATION 

DIGITAL provides a wide range of material and service 
options supporting this software product. Each option is 
described below. IF YOU ARE ALREADY FAMILIAR 
WITH THESE OPTIONS YOU MAY OBTAIN THE 
ORDERING INFORMATION DIRECTLY FROM THE 
SOFTWARE OPTIONS CHART. In most cases you will 
want to review the following descriptions to determine 
what options you require. 

You *.*."!! need s separate license iG" eacu ^ru on which 
you will be using the software product (except as other- 
wise specified by DIGITAL). Then you will select the mate- 
rials and service options you need to utilize the product 
effectively. 

You order the license, materials and services using order 
numbers of the form: Qxxxx-X?. "Qxxxx" refers to the 
specific software product, "X" is the license code or mate- 
rial service option and "?" is the selectable media code for 
machine readable materials. 

Single-Use licensed software is furnished under the 
licensing provisions of DIGITAL'S Standard Terms and 
Conditions of Sale, which provide in part that the software 
and any part thereof may be used on only the single CPU 
on which the software is first installed, and may be copied, 
in whole or in part (with the proper inclusion of DIGITAL'S 
copyright notice and any proprietary notices on the soft- 
ware) for use on such CPU. 

LICENSE OPTIONS 

Single-Use License Option 

The Single-Use License is your right to use the software 
product on a single CPU and it includes your 90 day war- 
ranty. 

For your first installation of this software product you must 
purchase as a minimum: 

• Single-Use License Option, and 

• Distribution and Documentation Option 



The license gives you the right to use the software on a 
single CPU and the Distribution and Documentation 



ed documentation. 



achine readable souware ana reiai- 



To use this software product on additional CPU's ,,/ypju 
must purchase as a minimum: 

• Single-Use License Option 

In addition to the right to use, the license give§ you the 
right to copy the software from your originai CPU installa- 
tion to the additional CPU. Therefore, the Distribution and 
Documentation option is not required, but optional. „ , 

MATERIALS AND SERVICE OPTIONS 

Distribution and Documentation Option 

The Distribution and Documentation option provides the 
software object code in binary form and the basic docu- 
mentation. You must have, or order, a Single- Use License 
to obtain this option. You will need this option to install the 
software for the first time. You will also need this option to 
obtain revised versions of the software product when they 
become available. ~0 

If you prefer to receive automatic distribution of revised 
versions for this product, you must purchase a Software 
Product Service Agreement. 

Software Revision Right-To-Copy Option 

The Right-To-Copy option allows a customer with multiple 
CPU's to copy a revised version of a software product 
from one CPU to another. Each CPU must be licensed for 
that product. You first install the revised software on one 
CPU; then you can make copies for additional CPU's by« 
purchasing the Right-To-Copy option for each additional 
CPU. r ' ; ^ 

!f you prefer tc automatically obtain the right-to-copy, you" 
must purchase a Service Right-to-Copy for each addition- 7 
al CPU; this is a service added to a Software Product) 
Service Agreement. 

Documentation-Only Option - ; 

You can obtain one copy of the basic documentation by-' 
purchasing the Documentation-Only option. ; ~ 

Installation Service Option 

Installation Service includes those services provided by a 
DIGITAL Software Specialist to successfully install a soft- 
ware product. Digital's Installation Service accelerates 
your productive use of this product. (If Operating System 
parameters must be changed, system regeneration may 
not be included in the Installation Service.) 

Installation Service will be provided at no additional 
charge (Courtesy Installation) under the conditions 
described in the Installation section above. 

NETstart Services Options 

NETstart Services help you "start-up" operation of your 
DECnet networking environment quickly by accelerating 
the learning process of your staff. It includes direct assis- , 
tance, documentation review, discussion and hands-on ,- 
experience provided on-site by a DIGITAL Networking " 
Specialist. NETstart is designed to benefit first time users, 
as well as experienced network computer users. 

There are two levels of NETstart Services. NETstart I is 
the most comprehensive start-up service, followed by 
NETstart II. 
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You should be experienced with your appropriate operat- 
ing systems prior to scheduling these services. Contact 
your DIGITAL representative for more details on NETstart 
Services. 

Software Product Service Agreements 

DIGITAL offers yqu„a choice of three Software Product 
Service Agreements to .support, your software. These 
agreements provide a set of the following services 
depending on the agreement .selected: remedial and 
maintenance service, revised versions of the software and 
documentation, telephone support and newsletters or dis- 
patches containing suggested fixes for known problems. 

The level of service you need depends primarily on three 
factors: (1) your available manpower, (2) your staff's level 
of expertise, and (3) the importance to you of having your 
system current and operating at peak efficiency. Our 
DIGITAL representative can help you select the service 
best suited to youn needs. The agreement types are listed 
below. 

DECsupport Service is designed for people requiring 
high availability of their system and for customers who 
need regular access to DIGITAL'S technical expertise. It is 
the most comprehensive support service, offering on-site 
preventative maintenance and remedial support for critical 
problems.. In addition, it-also provides revised versions of 
the software and documentation, fast response, tele- 
phone support and newsletters or dispatches. 

BASIC Service is ideal for customers who have their own 
technical staff but need fast answers to operational ques- 
tions. The telephone support provided in this service gives 
you timely answers and solves most software problems. 
In addition, you get revised versions of the software and 
documentation, and newsletters or dispatches. 

Self-Maintenance Service is designed for customers 
who require only minimal support but wish to receive 
revised versions of J.he software and documentation infor- 
mation from- v piGITAL. In addition, the service provides 
newsletters or dispatches. 

All agreements ire available to licensed DIGITAL custom- 
ers on an annual, contractual basis. 



The Prerequisite Software, as specified by this SPD, must 
have the equivalent level Software Product Service. 

A variety of service options may be added to an existing 
Software Product Service Agreement as follows: 

• Customers who want to copy the revised software 
received under their Software Product Service Agree- 
ment onto additional CPUs running that same product 
may order a Service Right-to-Copy for each "GP'U\ 
Qxxxx-3Z. 

• Customers who have a Software Product Service 
Agreement can obtain an additional copy of the docu- 
mentation supplied under the Agreement by ordering 
the Documentation Update Service, Qxxxx-KZ.~ HFC 

• Customers who have a Basic Service or DECsupport 
Service Agreement can add additional names to the 
three who, under the Agreement, may call th& Tejej 
phone Support Center by ordering the Additionaf Yeie-s 
phone Support Center Contact Service, Qxxxx-6Z. 

TRAINING FROM EDUCATIONAL" SERVICES 3 , 

To ensure customer success with DIGITAL products^ 
Educational Services sells training for the irisHartatibrj^ 
maintenance and/or management of DIGITAL softwares. 
Course formats vary from seminars to packaged training 
materials that include self-paced instruction and; 
ccmputer-based instruction to traditional lecture/labs' af 
DIGITAL'S 27 worldwide Training Centers. c ^i 

All course schedules, availability and purchasing informa- 
tion is listed in Educational Services' DIGEST, a quarterly 
publication designed to assist customers in planning their 
training programs. 

Professional Software Services 

DIGITAL Software Specialists are available on a per-calh 
or resident contract basis to help in all phases of sdffvftsrtir 
development or implementation. Specialists are available V 
to serve as technical consultants, decision support con- 
sultants or business systems analysts. Resources are 
available to: 

• Supplement your programming staff 

• Assume project management responsibility 

• Develop software ' 

• Assure successful start-up and performance with pro- 
duct specific packaged services 

Contact your DIGITAL representative for additional infor- 
mation and ordering details. 
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SOFTWARE OPTIONS CHART 



The distribution Media Codes used in the Software 
Options Chart are described below. You specify the 
desired Media Code at the end of the Order Number, e.g. 
£)J364-HD = binaries on 9-track 800 BPI Magtape 
(NRZI). - 



D = 9-track 800 BPI, Magfcpe^NRZl) 

H = RL02 Disk Cartridge * * „ H 

M = 9-track 1600 BPI Magtape (PE) 

Q = RLOIDisk Cartridge - 

T = RK06 Disk Cartridge 

V = RKOT^DiSk Cartridge 

Z = No hardvtfaire dependency, " 



NOTE: The availability of these software product options and services may vary by country. Customers" should contact-their 
iocai DIGITAL office for information on availability. 



OPTIONS 

-8''.' ■: '- " 


ORDER 
NUMBER 


ORDER 
NUMBER 


LICENSE OPTIONS^jLJCENSE 
IS REQUIRED FOR EACH CPU. 


FULL 
FUNCTION 


END 
NODE 


SinglerUse License 


QJ764-UZ 


QJ765-U* 


MATERIALS AND 
SERVICE OPTIONS: 




, 


CJ^stgbution and Documenta- 
tion Option 


QJ764-HD 
QJ764-HH 
QJ764-HM 
QJ764-HQ 
QJ764-HT 
QJ764-HV 


,cQJ765-HD 
QJ765-HH 
QJ765-HM, 
QJ765-HQ„ 
6J765-HT' 
QJ765-HV 


Software Revision 
Right-To-Copy Option 


QJ764-HZ 


QJ765-HZ " 


Documentation Only Option 


QJ764-GZ 


QJ765-GZ, , !r ^-H-> ; 


Instigation Service Option 


QJ764-ID 
QJ764-IH 
QJ764-IM 
QJ764-IQ 
QJ764-IT 
QJ764-IV 


QJ765-ID' 

OJ765-IH 

QJ765-IM 

QJ765-IQ 

QJ765-IT 


SOFTWARE PRODUCT 
SERVICE AGREEMENTS: 






DECsupport Service 


QJ764-9D 
QJ764-9H 
QJ764-9M 
QJ764-9Q 
QJ764-9T 
QJ764-9V 


QJ765-9D 
QJ765-9H 
QJ765-9M 
QJ765-9Q 
QJ765-9T 
QJ765-9V 


Basic Service 


QJ764-8D 
QJ764-8H 
QJ764-8M 
QJ764-8Q 
QJ764-8T 
QJ764-8V 


QJ765-8D 
QJ765-8H 
QJ765-8M 
QJ765-8Q 
QJ765-8T 
QJ7G5-8V 


Self-Maintenance Service 


QJ764-3D 
QJ764-3H 
QJ764-3M 
QJ764-3Q 
QJ764-3T 
QJ764-3V 


QJ765-3D 
QJ765-3H 
QJ765-3M 
QJ765-3Q 
QJ765-3T 
QJ765-3V 



